开源文件分享系统 FileCodeBox 安装教程

开源文件分享系统 FileCodeBox 安装教程

FileCodeBox 是一款轻量级的开源文件分享系统,它最大的特点就是匿名口令分享。就像取快递一样,上传文件后生成一个取件码,对方凭借取件码即可下载,无需注册账号,非常适合临时传输文件或文本。

以下是基于你提供的参考链接整理的保姆级部署教程:

🚀 第一步:准备工作

在开始之前,请确保你已经拥有一台运行 Linux 系统的服务器(如 Ubuntu/CentOS 等),并以管理员权限登录。

  1. 安装 1Panel 面板
    如果你的服务器上还没有安装 1Panel,需要先安装面板。你可以参考官方文档或过往博客进行安装。安装完成后,通过浏览器访问 https://你的服务器IP:31216 进入 1Panel 登录界面。

📦 第二步:一键安装 FileCodeBox

1Panel 的应用商店已经集成了 FileCodeBox,我们可以直接一键安装,无需手动输入复杂的 Docker 命令。

  1. 登录 1Panel 面板后,点击左侧菜单栏的 【应用】 -> 【应用商店】

  2. 在搜索框中输入 FileCodeBox 或者在分类“实用工具”中找到它。

  3. 点击应用图标进入详情页,然后点击右上角的 【安装】 按钮。

  4. 在弹出的配置窗口中,保持默认设置即可。特别注意:勾选“外部访问”选项(如果面板支持自动放行);确保“端口映射”中的外部端口(如 12345)在防火墙中是放行的。

  5. 点击 【确认】,等待系统自动完成安装。

⚙️ 第三步:配置数据存储(重要)

为了方便管理和持久化数据,建议修改默认的文件存储路径。

  1. 安装完成后,进入 1Panel 的 【容器】 列表,找到 filecodebox 对应的容器。

  2. 点击右侧操作栏的 【更多】 -> 【编辑】

  3. 切换到 【挂载】 选项卡:

    • 删除 默认的映射路径(本机目录为 /1panel/apps... 的那一行)。

    • 添加 新的挂载卷:

      • 本机目录:填写你希望存储文件的路径,例如 /www/filecodebox/data(如果目录不存在请先创建)。

      • 容器目录:填写 /app/data

      • 权限:选择 读写

  4. 点击 【确认】 保存并重启容器。

🔓 第四步:访问与后台配置

  1. 前台访问
    在浏览器输入地址访问:http://你的服务器IP:12345(端口号为你安装时设置的外部端口)。

    • 你会看到“快递柜”界面,可以尝试上传一个文件测试是否正常。

  2. 后台登录

    • 后台地址http://你的服务器IP:12345/#/admin

    • 默认密码FileCodeBox2023(首次登录后请务必修改!)

  3. 基础设置
    登录后台后,建议进行以下配置:

    • 修改管理密码:在“系统设置”中更改默认密码,保障安全。

    • 调整文件限制:根据需求修改“文件大小限制”(默认 10MB)和“上传限制”。

    • 关闭游客上传(可选):如果不想让陌生人随意上传文件,可以在“系统配置”中关闭“开启上传”,这样只有登录后台才能上传文件。

📝 常用配置参数速查表

表格

配置项

默认值/说明

建议操作

访问端口

12345

确保服务器防火墙放行

后台路径

/#/admin

访问该路径进入管理面板

初始密码

FileCodeBox2023

首次登录立即修改

数据存储

/app/data

建议挂载到服务器本地目录

💡 常见问题

  • Q: 安装后无法访问?
    A: 请检查服务器的安全组(阿里云/腾讯云控制台)和 1Panel 面板的防火墙,确保你映射的端口(如 12345)是放行状态。

  • Q: 如何更新版本?
    A: 在 1Panel 的应用管理或容器列表中,卸载旧版本并重新安装最新版本即可。注意备份好数据目录 /app/data 以防丢失配置。

  • Q: 提示权限错误?
    A: 如果你在挂载目录时遇到权限问题,可以尝试在服务器终端执行 chmod -R 777 /www/filecodebox(路径替换为你自己的路径)赋予读写权限。

深入剖析Tomcat的底层架构与运行机制 2026-07-02
Java 中 SSE (Server-Sent Events) 流式输出与调用完全指南 2026-07-16

评论区