基于 Go 语言实现的轻量级文件服务器，支持文件上传下载和参数传递。
本项目基于 FileServer 开源项目进行扩展和改进。
- ✅ 静态文件下载
- ✅ 文件带账密上传功能
- ✅ 自动创建目录
- ✅ 多架构支持（amd64/arm64）
- ✅ 无依赖运行
- ✅ 支持Kubernetes
# 编译
cd GoFileserver
go build -o GoFileserver
# 运行
./GoFileserver -port 8080 -path ./www# docker-compose.yml
version: '3'
services:
gofileserver:
build: .
container_name: GoFileserver
restart: unless-stopped
ports:
- '8080:8080'
volumes:
- ./www:/web/www# 基本下载
curl http://localhost:8080/path/to/file -o local-file# 基本上传
curl -X POST http://localhost:8080 -F "file=@local-file"
# 带参数上传（指定目录）
curl -X POST http://localhost:8080 -F "file=@local-file" -F "dir=upload"# 创建输出目录
mkdir -p output
# 编译 amd64 版本
GOOS=linux GOARCH=amd64 go build -o output/GoFileserver_linux_amd64
# 编译 arm64 版本
GOOS=linux GOARCH=arm64 go build -o output/GoFileserver_linux_arm64| 参数 | 默认值 | 说明 |
|---|---|---|
| -port | 8080 | 服务器监听端口 |
| -path | ./www | 文件存储路径 |
| -c | default | 配置方式（default/env） |
| -user | "" | 认证用户名（为空表示不需要认证） |
| -pass | "" | 认证密码（为空表示不需要认证） |
| 环境变量 | 对应参数 | 说明 |
|---|---|---|
| WEB_PORT | -port | 服务器监听端口 |
| WEB_PATH | -path | 文件存储路径 |
| AUTH_USER | -user | 认证用户名 |
| AUTH_PASS | -pass | 认证密码 |
GoFileserver 支持基本的 HTTP 认证功能，可以通过以下方式启用：
./GoFileserver -port 8080 -path ./www -user admin -pass password123docker run -d -p 8080:8080 -v ./www:/web/www \
-e AUTH_USER=admin -e AUTH_PASS=password123 \
registry.cn-hangzhou.aliyuncs.com/public_hjj_images/go-fileserver:latest使用 curl 访问需要认证的服务：
# 下载文件
curl -u admin:password123 "http://localhost:8080/path/to/file" -o local-file
# 上传文件
curl -u admin:password123 -X POST http://localhost:8080 \
-F "file=@local-file" -F "dir=upload"curl -X POST http://localhost:8080 -F "[email protected]" -F "dir=docs"curl http://localhost:8080/docs/test.txt -o test.txt# 应用部署配置
kubectl apply -f k8s-deployment.yaml
# 查看部署状态
kubectl get deployments
kubectl get pods
kubectl get services# 应用部署配置（包含 PV 和 PVC）
kubectl apply -f k8s-deployment-pvc.yaml
# 查看部署状态
kubectl get pv
kubectl get pvc
kubectl get deployments
kubectl get pods
kubectl get services# 应用部署配置（包含 PV、PVC 和 Ingress）
kubectl apply -f k8s-deployment-ingress.yaml
# 查看部署状态
kubectl get pv
kubectl get pvc
kubectl get deployments
kubectl get pods
kubectl get services
kubectl get ingress服务将通过 NodePort 暴露在 30080 端口：
# 访问地址
http://<节点IP>:30080通过 Ingress 配置，可以使用域名访问服务：
-
配置域名解析：
- 将
fileserver.example.com解析到您的 Kubernetes 集群入口 IP
- 将
-
访问地址：
http://fileserver.example.com
-
自定义域名：
- 编辑
k8s-deployment-ingress.yaml文件，将fileserver.example.com改为您自己的域名
- 编辑
- 副本数：1
- 容器端口：8080
- NodePort：30080
- 资源限制：CPU 1核，内存 512Mi
- 健康检查： readiness 和 liveness 探针
- 存储：使用 emptyDir 临时存储
- 副本数：1
- 容器端口：8080
- NodePort：30080
- 资源限制：CPU 1核，内存 512Mi
- 存储：使用 PersistentVolume 和 PersistentVolumeClaim
- PV：10Gi 存储空间，hostPath 类型
- PVC：5Gi 存储请求
- 存储路径：
/data/gofileserver
- 副本数：1
- 容器端口：8080
- 服务类型：ClusterIP
- 资源限制：CPU 1核，内存 512Mi
- 存储：使用 PersistentVolume 和 PersistentVolumeClaim
- PV：10Gi 存储空间，hostPath 类型
- PVC：5Gi 存储请求
- 存储路径：
/data/gofileserver
- Ingress 配置：
- 域名：
fileserver.example.com - 路径：
/ - 后端服务：gofileserver:8080
- 注解：
- 使用 nginx ingress 控制器
- 文件上传大小限制：100MB
- 代理读写超时：10分钟（适合大文件传输）
- 域名：
GPL-3.0 License