FileCodeBox Docker 容器部署:一条命令跑通自托管文件分享系统
【免费下载链接】FileCodeBox文件快递柜-匿名口令分享文本,文件,像拿快递一样取文件(FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files)项目地址: https://gitcode.com/GitHub_Trending/fi/FileCodeBox
FileCodeBox(文件快递柜)是一款轻量级的开源文件分享系统:你把文件或文本传上去,系统生成一个匿名提取口令,对方凭口令像取快递一样拿走文件,无需注册账号。基于 Docker 的容器化部署方式是官方推荐的路径,适合想快速搭建、长期少折腾的个人站长和中小团队。
先搞清楚它适合谁
传统传文件要么走网盘注册流程繁琐,要么丢到第三方临时链接里心里没底。FileCodeBox 把这件事变成三步:上传、拿到口令、对方取件,文件和数据都留在你自己的服务器上。整个服务只占用一个端口、一个挂载目录,对硬件要求很低,一台 1GB 内存的 Linux 小机器就能跑。
部署前检查清单
动手之前花两分钟确认三件事,能避开后面 90% 的麻烦:
| 检查项 | 要求 | 为什么 |
|---|---|---|
| Docker 环境 | 已安装并可正常运行容器 | 官方镜像基于它交付,免去手动装依赖 |
| 内存 | 建议 1GB 以上 | 保证服务与日志正常运转 |
| 端口 | 12345 未被占用 | 服务默认监听该端口 |
顺手把数据目录建好并放行读写权限:
mkdir -p /opt/FileCodeBox chmod 777 /opt/FileCodeBox这一步的意义在于:后面容器会把所有文件、数据库都写进这个目录,提前给足权限,容器起来后就不会卡在写入环节。
一条命令跑起来
确认无误后,执行下面这条命令(lanol/filecodebox为官方镜像):
docker run -d --restart=always \ -p 12345:12345 \ -v /opt/FileCodeBox/:/app/data \ --name filecodebox \ lanol/filecodebox:beta📌 每个参数各管一件事:
-d:后台运行,终端立即返回;--restart=always:宿主机重启后容器自动拉起,一次配置长期省心;-p 12345:12345:把容器端口映射到宿主机,前段是对外端口,可改;-v /opt/FileCodeBox/:/app/data:挂载数据卷,实现数据持久化,容器删了数据还在;--name filecodebox:起个名字,方便后续docker ps、docker logs定位;lanol/filecodebox:beta:镜像名加标签,拉取的就是这份代码。
执行完这条命令,容器就已经在后台跑着了。
验证服务是否就绪
打开浏览器访问:
http://服务器IP:12345能打开页面就说明网络链路通了。首次访问会进入初始化流程,按提示设置管理员口令,之后通过/admin后台可以管理文件、查看统计、调整配置。
建议顺手做两个动作验证部署是否完整:上传一个测试文件,确认能生成提取口令;再换个网络(比如手机流量)凭口令取回,确认下行链路正常。两步都通过,就算正式跑通了。
跑通之后:三个调优选项
跑通只是起点,下面三件事让服务在长期运行中更稳:
- 换端口。如果 12345 不合意,只需改映射的前半段:
docker run -d -p 8080:12345 [其他参数保持不变]容器内部端口始终是 12345,宿主机侧随意指定。
- 定期备份。所有状态都集中在挂载目录里,打包一份即可恢复:
tar -czvf filecodebox_backup_$(date +%Y%m%d).tar.gz /opt/FileCodeBox- 限制资源。给容器设内存与 CPU 上限,防止它影响同机其他服务:
--memory=512m --cpus=1常见坑与快速解法
| 症状 | 原因 | 处理办法 |
|---|---|---|
| 容器起不来、端口报错 | 12345 被别的进程占了 | netstat -tulnp \| grep 12345找出占用者,换掉端口映射前段 |
| 页面正常但上传失败 | 挂载目录没有写权限 | chown -R 1000:1000 /opt/FileCodeBox修正属主 |
| 不确定服务状态 | —— | docker ps -a \| grep filecodebox查看运行与退出原因 |
镜像升级同样很简单:先docker pull拉新标签,再重建容器。仓库根目录自带 docker-compose.yml,习惯用 Compose 的同学可以直接docker-compose down && docker-compose up -d完成切换。更多参数与环境变量说明见 快速开始文档 与 存储配置。
写在最后
部署到这里已经是一个可用的私有文件分享站。下一步的进阶方向是把 Nginx 反代到这台服务前面、配上 HTTPS 证书,并收紧 12345 端口的对外暴露——做完这两步,安全性会上一个台阶。具体的限流与访问保护策略可以参考 安全设置文档。
【免费下载链接】FileCodeBox文件快递柜-匿名口令分享文本,文件,像拿快递一样取文件(FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files)项目地址: https://gitcode.com/GitHub_Trending/fi/FileCodeBox
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考