跳转至

安装部署

部署一套 APIC 只需两步:装面板,再把节点接进来。更新中心(hub)是官方维护的,你不用自建。

本页含占位符

下面带 <尖括号> 的是需要你按自己环境替换的值(域名、命令、服务名)。命令以你拿到的安装包 / 面板内显示为准。

0. 准备

  • 一台用于跑面板的服务器(Linux,建议 Debian/Ubuntu)。
  • 一台或多台用于跑节点的服务器(接入层 / 协议层)。
  • 一份授权(从官方授权渠道获取)。面板需通过授权校验方可正常运行。

1. 安装面板(master)

将面板安装包部署到面板服务器,按包内说明启动。安装完成后:

  1. 浏览器访问 https://<你的面板域名>/ 打开后台。
  2. 用初始管理员账号登录(初始凭据见你的安装输出 / 交付信息)。
  3. 进入设置,填入授权信息并保存。

面板服务

面板以 systemd 服务运行(常见名 fp-master,以你部署时设定为准)。确认服务名:

systemctl list-units --type=service | grep -iE 'forward|master|fp-|panel'

常用操作见 常用命令。

2. 接入节点(agent)

节点通过在目标服务器上运行 agent 接入面板。推荐用面板生成的安装命令,省去手填参数:

  1. 面板 → 节点 → 新增节点,填写名称、选择所属线路 / 层(接入层或协议层)。
  2. 面板会给出该节点的一键安装命令,复制它。
  3. 登录到这台节点服务器,以 root 执行该命令。
  4. 稍候回到面板,节点应显示在线。

安装命令本质上是把 agent 拉到机器上、写好与面板对接的参数并注册为 systemd 服务 fp-agent。若需手动安装,参考你安装包内的 install.sh:

# 形式示例;实际参数以面板生成的命令为准
bash install.sh --server <面板地址> --key <节点密钥>

安装后确认 agent 在跑:

systemctl status fp-agent
journalctl -u fp-agent -f      # 跟踪日志,排查接入问题

3. 验证

  • 节点 页:新节点为在线,且未显示"需更新"徽标。
  • 建一条最简单的直连规则(见 转发规则),用客户端连接监听端口,确认能通。

节点显示『需更新』

说明该 agent 的协议版本落后于当前面板,需重新部署 agent(协议升级后必须更新节点,否则新特性不生效)。详见 更新升级。

4. 后续