codeskyblue/gohttpserver

gohttpserver镜像说明

镜像概述

gohttpserver是一款轻量高效的HTTP文件服务器，基于Golang开发，旨在提供便捷的文件共享与分发服务。它支持文件上传、移动应用安装包（.apk/.ipa）***生成、多维度认证控制及自定义配置，广泛适用于本地资源分享、团队内部文件交换、移动应用测试包发布等场景。

核心功能

• 人性化UI：面包屑导航、文件类型图标区分、主题切换
• 移动支持：自动生成.apk/.ipa安装包***（ipa需HTTPS环境）
• 文件操作：上传、删除、创建文件夹、批量zip下载
• 认证机制：HTTP Basic Auth、OpenID、OAuth2-proxy
• 高级特性：全局文件搜索、隐藏文件管理、.ghs.yml自定义目录权限
• 部署适配：支持Nginx反向代理、HTTPS环境及plist代理

使用场景

1. 本地文件共享：快速搭建临时服务器分享当前目录文件
2. 移动应用分发：生成安装包***，方便测试人员扫码安装
3. 团队资源管理：共享文档/工具包，通过认证控制访问权限
4. 开发环境预览：快速展示静态资源或项目文件

配置说明

Docker部署示例

基础运行（共享当前目录）

bash
docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver docker.xuanyuan.run/codeskyblue/gohttpserver

带HTTP Basic Auth认证

bash
docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver \
  docker.xuanyuan.run/codeskyblue/gohttpserver \
  --auth-type http --auth-http username:password

开启上传与删除权限

bash
docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver \
  docker.xuanyuan.run/codeskyblue/gohttpserver \
  --upload --delete

高级配置

• 目录权限自定义：在目标目录创建.ghs.yml文件，设置上传/删除权限、用户白名单等
• Nginx反向代理：需添加--xheaders参数，并配置Nginx的client_max_body_size 0以支持大文件上传
• HTTPS适配：苹果ipa文件需HTTPS环境，可使用plist代理或直接部署HTTPS服务器
• 主题切换：通过界面设置选择"black"或"green"主题

该镜像遵循MIT开源协议，可自由使用与二次开发。