filecodebox

FileCodeBox (Go)

轻量且高性能的文件/文本分享服务，使用 Go 实现，支持分片上传、秒传、断点续传与多种存储后端。

核心目标是提供一个易部署、易扩展的文件快传系统，适合自托管与容器化部署场景。

主要特性

• 高性能：基于 Go 的并发能力构建，低延迟与内存占用
• 文件/文本分享：支持短链接分享文本和文件
• 分片上传：大文件分片、断点续传、上传校验与秒传支持
• 管理后台：内置管理控制台，可管理文件、配置与用户
• 多存储后端：支持本地、S3、WebDAV、OneDrive（可扩展）
• 容器友好：提供 Docker 与 docker-compose 支持
• 主题系统：前端主题可替换与定制

环境要求

开发推荐使用 Go 1.25+。项目默认使用 SQLite 作为开发环境的轻量数据库。生产环境请按需选择存储与资源配置。

部署建议（简要）

• 推荐使用 Docker + 反向代理（Nginx）启用 HTTPS
• 将 data/ 目录做定期备份
• 将服务放入进程管理（systemd / 容器重启策略）

开发与扩展

• 新增存储：实现 storage.StorageInterface 并在 storage.NewStorageManager 注册
• 新增接口：在 internal/services 实现业务逻辑，并在 internal/handlers 与 internal/routes 添加路由

运行测试与示例脚本请查看 tests/ 目录。

常见问题与排查（示例）

• 检查端口占用：

lsof -ti:12345

• 如果数据库被锁或服务异常，尝试重启服务或检查 data/ 下的 sqlite 文件权限。

许可证

MIT

如需我继续：

• 将 README 翻译为英文
• 自动生成或更新 Swagger 文档
• 补全详细部署示例（Kubernetes / systemd）

请告诉我接下来要做哪个扩展。

FileCodeBox Go版本

🚀 FileCodeBox的高性能Golang实现 - 开箱即用的文件快传系统

✨ 特性

• 🔥 高性能 - Golang实现，并发处理能力强
• 📁 文件分享 - 支持各种格式文件的快速分享
• 📝 文本分享 - 支持文本内容的快速分享
• 🔧 分片上传 - 支持大文件分片上传，断点续传
• ⚡ 断点续传 - 网络中断后可恢复上传，支持秒传
• ⏰ 灵活过期 - 支持时间和次数两种过期方式
• 🛡️ 安全可靠 - JWT认证、限流保护、权限控制
• 📊 管理后台 - 完整的文件管理和系统配置
• 🗄️ 多存储 - 支持本地、WebDAV、S3存储
• 🐳 容器化 - 开箱即用的Docker部署
• 🎨 主题系统 - 支持多主题切换

快速开始

直接运行

# 安装依赖
go mod tidy

# 编译并运行
go build -o filecodebox
./filecodebox

服务启动后访问 http://localhost:12345 即可使用。

Docker运行

# 构建镜像
docker build -t filecodebox-go .

# 运行容器
docker run -d -p 12345:12345 -v ./data:/root/data filecodebox-go

Docker Compose

docker-compose up -d

多架构 Docker 构建

支持 ARM64 和 AMD64 架构的 Docker 镜像构建：

# 构建多架构镜像
./build-docker.sh

# 构建指定架构
./build-docker.sh --single linux/arm64
./build-docker.sh --single linux/amd64

配置

配置文件会自动生成在 data/config.json，主要配置项：

• port: 服务端口（默认12345）
• name: 站点名称
• upload_size: 最大上传大小
• file_storage: 存储类型（local/s3/webdav/onedrive）
• 管理员认证改为使用管理员用户名/密码登录并通过 Authorization: Bearer <token> 使用 JWT（不再使用静态管理员令牌配置）

管理员后台

访问方式

• 管理员页面：http://localhost:12345/admin/
• 默认密码：FileCodeBox2025

主要功能

• 📊 系统统计 - 查看文件数量、存储使用情况
• 📁 文件管理 - 管理所有分享的文件
• ⚙️ 系统配置 - 配置站点信息、上传限制等
• 👥 用户管理 - 启用用户系统、管理用户权限
• 💾 存储配置 - 配置本地、S3、WebDAV等存储方式

初始配置建议

1. 首次启动后，立即访问管理员页面修改默认密码
2. 根据需要配置存储方式（本地存储/云存储）
3. 设置合适的上传大小限制
4. 配置站点名称和描述信息

管理后台静态资源的安全说明

管理后台使用了一组专用静态资源（位于 themes/<theme>/admin/），这些文件包含管理界面的 JavaScript、CSS 与模板。

为了避免未授权用户直接访问管理后台页面并读取敏感前端逻辑，服务已将管理专用静态资源改为仅在管理员认证后提供：

• 管理前端入口 GET /admin/ 需要有效的管理员 JWT（通过 Authorization: Bearer <token> 方式传递）。
• 管理专用静态路径（例如 /admin/js/*, /admin/css/*, /admin/templates/*, /admin/assets/*, /admin/components/*）也仅在认证通过后提供。
• 公共资源（用户前端和通用资源）仍通过 /js/*, /css/*, /assets/*, /components/* 对外公开，以支持用户页面和登录流程。

部署注意：如果你的生产环境在前面放了 Nginx、CDN 或其它反向代理，请确保对 /admin/* 不做缓存并不要将 admin 静态事先缓存到代理上，否则可能绕过后端认证。建议在代理上为 /admin/* 添加 Cache-Control: no-store 或根据代理文档设置不缓存规则。

如果需要把少量引导或 favicon 等资产在未认证时可用，请将这些文件放入主题的 assets/ 目录（由 /assets/* 提供），不要将管理专用目录下的文件放到公共路径。

API接口

分享文本

POST /share/text/

分享文件

POST /share/file/

获取分享内容

GET /share/select/?code=xxx
POST /share/select/

分片上传和断点续传

POST /chunk/upload/init/          # 初始化分片上传
POST /chunk/upload/chunk/:upload_id/:chunk_index # 上传分片
POST /chunk/upload/complete/:upload_id            # 完成上传
GET  /chunk/upload/status/:upload_id              # 获取上传状态
POST /chunk/upload/verify/:upload_id/:chunk_index # 验证分片
DELETE /chunk/upload/cancel/:upload_id            # 取消上传

管理接口

GET /admin/stats         # 统计信息
GET /admin/files         # 文件列表
DELETE /admin/files/:id  # 删除文件
GET /admin/config        # 获取配置
PUT /admin/config        # 更新配置

项目结构

├── assets/                 # 项目资源文件
│   └── images/logos/       # Logo 和图标文件
├── docs/                   # 文档目录
│   ├── changelogs/         # 改动记录和版本日志
│   ├── design/             # 设计相关文档
│   └── *.md               # 其他文档
├── scripts/               # 脚本文件
│   ├── build-docker.sh    # Docker 构建
│   ├── deploy.sh          # 部署脚本
│   └── *.sh              # 其他脚本
├── main.go                # 主程序入口
├── internal/              # Go 源代码
│   ├── config/            # 配置管理
│   ├── database/          # 数据库初始化
│   ├── models/            # 数据模型
│   ├── services/          # 业务逻辑
│   ├── handlers/          # HTTP处理器
│   ├── middleware/        # 中间件
│   ├── storage/           # 存储接口
│   ├── routes/            # 路由设置
│   └── tasks/             # 后台任务
├── themes/                # 主题文件
│   └── 2024/              # 2024年主题
├── data/                  # 数据目录
├── tests/                 # 测试文件
└── docker-compose.yml     # Docker编排

与Python版本的差异

1. 性能提升: Go版本具有更好的并发性能和更低的内存占用
2. 依赖更少: 不需要Python运行时环境
3. 部署简单: 编译后为单一可执行文件
4. 类型安全: 静态类型系统减少运行时错误
5. 容器优化: 支持多架构Docker镜像，更小的镜像体积

环境要求

开发环境

• Go 1.25+
• SQLite3（用于数据存储）
• Git（用于代码管理）

生产环境

• Linux/macOS/Windows
• 至少 512MB 内存
• 推荐使用 Docker 部署

部署建议

Docker 部署（推荐）

# 使用 docker-compose（最简单）
docker-compose up -d

# 或手动运行 Docker
docker run -d \
  --name filecodebox \
  -p 12345:12345 \
  -v ./data:/root/data \
  --restart unless-stopped \
  filecodebox-go

直接部署

# 编译
go build -ldflags="-w -s" -o filecodebox

# 创建系统服务（可选）
sudo cp filecodebox /usr/local/bin/
sudo systemctl enable filecodebox
sudo systemctl start filecodebox

开发

添加新的存储后端

1. 实现 storage.StorageInterface 接口
2. 在 storage.NewStorageManager 中注册新存储
3. 在配置中添加相关配置项

添加新功能

1. 在 models/ 中定义数据模型
2. 在 services/ 中实现业务逻辑
3. 在 handlers/ 中添加HTTP处理器
4. 在 routes/ 中注册路由

安全建议

• 🔐 修改默认密码: 首次部署后立即修改管理员默认密码
• 🛡️ 使用HTTPS: 生产环境建议配置SSL证书
• 🔥 防火墙配置: 只开放必要的端口（如12345）
• 📊 定期备份: 定期备份 data 目录
• 🚫 访问控制: 根据需要启用用户系统和权限控制

故障排除

常见问题

1. 端口被占用

   # 检查端口占用
   lsof -ti:12345
   # 杀掉占用进程
   lsof -ti:12345 | xargs kill -9
   

2. 数据库锁定

   # 重启服务即可解决
   pkill -f filecodebox
   ./filecodebox
   

3. 文件权限问题

   # 确保data目录有正确权限
   chmod -R 755 data/
   

日志查看

# 查看应用日志
./filecodebox 2>&1 | tee app.log

# Docker 容器日志
docker logs filecodebox

许可证

MIT License