MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

MgFileBox

MgFileBox 是一个面向个人 VPS 部署的私有文件分享站。它提供管理员登录、文件上传、分享链接、提取码、过期清理和分享管理能力，适合用于个人临时传文件、向指定对象分享文件或搭建轻量私有网盘入口。

预览图

预览页面

功能特性

管理员密码登录
单文件或多文件分享
分享链接自动生成
单条分享访问密码
带提取码的直达分享链接
分享过期时间，支持永不过期
分享管理页，支持查看有效分享和已删除分享
软删除分享，并移除本地文件
定时清理过期分享和过期登录会话
手机和 PC 自适应页面

技术栈

Go 1.25
Gin
SQLite
Go HTML Template
原生 CSS 和 JavaScript

快速开始

下载对应平台的发布包并解压

tar -xzf mgfilebox-vX.Y.Z-linux-amd64.tar.gz
cd mgfilebox

Windows 用户可下载 .zip 发布包，解压后进入 mgfilebox 目录。

复制并编辑配置文件

cp .env.example .env

至少设置以下变量：

ADMIN_PASSWORD=你的管理员密码COOKIE_SECRET=一串足够长的随机字符串APP_BASE_URL=https://你的域名

运行

chmod +x ./mgfilebox
./mgfilebox

Windows 下运行：

.\mgfilebox.exe

打开浏览器访问

http://localhost:8080/login

注意：程序启动时会自动读取运行目录下的 .env 文件。系统环境变量优先级高于 .env，生产环境也可以通过 systemd、Docker 或进程管理工具配置环境变量。

发布包内必须保留 web/templates 和 web/static。当前程序使用相对路径加载模板、静态资源和默认 ./data，建议在解压后的 mgfilebox 目录内运行可执行文件。

配置说明

配置项来自环境变量或运行目录下的 .env 文件，可参考 .env.example。如果两边同时设置，系统环境变量优先。

变量	说明	默认值
`PORT`	HTTP 监听端口	`8080`
`APP_BASE_URL`	对外分享链接基础地址	`http://localhost:8080`
`ADMIN_PASSWORD`	明文管理员密码，启动时转换为 bcrypt hash	无
`ADMIN_PASSWORD_HASH`	已生成的 bcrypt 管理员密码 hash	无
`COOKIE_SECRET`	Cookie 签名和提取码加密密钥	空时随机生成
`DATA_DIR`	数据根目录	`./data`
`UPLOAD_DIR`	上传文件目录	`./data/uploads`
`DB_PATH`	SQLite 数据库路径	`./data/app.db`
`SESSION_TTL_HOURS`	管理员会话有效小时数	`24`
`CLEANUP_INTERVAL_MINUTES`	过期内容清理间隔	`30`
`MAX_UPLOAD_SIZE_MB`	上传 multipart 内存上限	`512`

生产环境请固定设置 COOKIE_SECRET，否则重启后已有提取码链接和解锁 Cookie 可能失效。

开发者

源码构建和测试命令：

# 编译
mkdir -p bin
go build -o ./bin/mgfilebox ./cmd/server
# 运行
./bin/mgfilebox
# 测试
go test ./...

Windows 下如果需要生成 .exe，可使用 go build -o ./bin/mgfilebox.exe ./cmd/server，运行时执行 .\bin\mgfilebox.exe。

查看版本：

./bin/mgfilebox --version

发布构建时可通过 ldflags 注入版本号：

go build -ldflags "-X main.version=0.1.0" -o ./bin/mgfilebox ./cmd/server

更详细的工程开发说明见 docs/development-guide.md。

部署建议

使用 Nginx 或 Caddy 做 HTTPS 反向代理。
使用 systemd、Supervisor 或其他进程管理工具守护服务。
生产环境建议配置独立数据目录，例如 /opt/mgfilebox/data。
生产环境务必设置 APP_BASE_URL、COOKIE_SECRET，并设置 ADMIN_PASSWORD 或 ADMIN_PASSWORD_HASH。
建议定期备份 SQLite 数据库和上传文件目录。

项目结构

cmd/server/ 服务入口
internal/config/ 配置加载
internal/models/ 领域模型
internal/repository/ SQLite 数据访问
internal/security/ 密码、签名、加密和随机值
internal/service/ 核心业务逻辑
internal/web/ Gin 路由和 HTTP handler
web/templates/ HTML 模板
web/static/ 静态资源
docs/ 开发文档

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/server		cmd/server
docs		docs
internal		internal
web		web
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
PREVIEW.md		PREVIEW.md
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/server		cmd/server
docs		docs
internal		internal
web		web
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
PREVIEW.md		PREVIEW.md
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/server		cmd/server
docs		docs
internal		internal
web		web
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
PREVIEW.md		PREVIEW.md
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/server		cmd/server
docs		docs
internal		internal
web		web
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
PREVIEW.md		PREVIEW.md
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
cmd/server		cmd/server
docs		docs
internal		internal
web		web
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
PREVIEW.md		PREVIEW.md
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Latest commit

History

Folders and files

Repository files navigation

MgFileBox

预览图

功能特性

技术栈

快速开始

配置说明

开发者

部署建议

项目结构

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MgFileBox

预览图

功能特性

技术栈

快速开始

配置说明

开发者

部署建议

项目结构

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MgFileBox

预览图

功能特性

技术栈

快速开始

配置说明

开发者

部署建议

项目结构

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

MgFileBox

预览图

功能特性

技术栈

快速开始

配置说明

开发者

部署建议

项目结构

About