跳转到内容
FF1 FF1 FF1 文档

安装 FF1 Master

生产环境用官方脚本部署 FF1 Master，并妥善保管 FF1_SECRET_KEY 等密钥。

前置条件

Section titled “前置条件”
  • 一台满足 环境要求 的 Linux 服务器（数据用内嵌 SQLite，无需另装数据库）
  • 已在官网领取社区版或购买，持有 License Key（见 授权激活）

一键安装

Section titled “一键安装”

安装命令随授权发放，不公开在文档中。获取方式二选一：

  • 查看开通邮件中的安装说明；或
  • 登录个人中心 → 我的授权，查看对应的安装命令。

拿到命令后以 root 执行即可。脚本会：

  1. 下载并安装 FF1 Master，配置写入 /etc/ff1/
  2. 首次生成主密钥 FF1_SECRET_KEY（升级不覆盖，务必离线备份）
  3. 生成管理员账号（FF1_ADMIN_USERNAME / FF1_ADMIN_PASSWORD），凭据按脚本提示保存
  4. 初始化内嵌 SQLite 数据（存于数据目录，无需外部数据库）
  5. 注册并启动 ff1-master systemd 服务

关键配置

Section titled “关键配置”

| 项 | 说明 | |------|------| | /etc/ff1/ | 配置目录（服务端口、数据目录、功能开关） | | FF1_SECRET_KEY | 加密主密钥，丢失将无法解密已存数据，必须备份 | | FF1_HTTP_ADDR | Master 监听地址，默认 :80 | | FF1_PUBLIC_URL | 对外访问地址，用于装机脚本回填 |

改配置后重启：

Terminal window
sudo systemctl restart ff1-master

HTTPS 与反代（建议）

Section titled “HTTPS 与反代（建议）”

生产建议前置 Nginx / Caddy 终止 TLS，反代到 Master 监听端口。控制台与装机向导使用浏览器访问的 origin 作为对外地址。

验证

Section titled “验证”
  1. 浏览器打开 Master 地址，用管理员账号登录
  2. 控制台首页显示授权状态与版本
  3. 到 授权激活 填入 License Key

常见问题

Section titled “常见问题”

Q：启动失败 / 数据目录报错？ A：确认数据目录可写、磁盘未满；SQLite 数据文件随服务自动创建，无需手动建库。

Q：忘记管理员密码？ A：可通过设置 FF1_ADMIN_USERNAME / FF1_ADMIN_PASSWORD 后重启服务重置（以安装脚本帮助为准）。

下一步

Section titled “下一步”