常见问题

购买与授权

Q: 有免费版吗？

A: 没有。Zero Forwarder 只提供付费授权，$6 / 月起，包含 50 个用户、50 台机器、10 TB 月流量。需要更大规模可以联系我们定制。

Q: 安装需要的 ZFC_INSTANCE_ID 和 ZFC_API_KEY 从哪来？

A: 购买授权后获得。一份授权对应一个面板实例。

安装相关

Q: 安装脚本执行失败怎么办？

A: 请检查以下几点：

1. 网络连接：确保能够访问 GitHub 和安装源

   curl -I https://get.zeroforwarder.com/install.sh

2. 权限问题：确保有足够的权限安装软件

   sudo bash <(curl -sL https://get.zeroforwarder.com/install.sh)

3. 系统兼容性：检查您的系统是否受支持

   uname -a
   lsb_release -a  # Linux

Q: 显示一直离线

A: 检查面板机器的3100和443是否可以被此服务器访问，是否有防火墙，确保控制器域名没有开启CF小黄云。可以尝试访问控制器域名，如果有内容则正常。
检查时间是否同步, 如果不同步，可能需要重启一下机器，或者自行进行时间同步。

timedatectl status

配置相关

Q: 配置文件在哪里？

A: 服务器(worker)默认配置文件位置：
默认 /root/zf/config.json
转发端点:
/opt/fwd_xxxxxx/config.json

网络相关

Q: 转发链不通

A: 可以尝试修改’转发链测试方法’，等待30s。

关于UDP

不同场景下UDP的处理逻辑不同:
1、直连场景(非隧道): 原生UDP
2、隧道场景:
2.1 聚合场景: Uot
2.2 一级隧道: 默认原生UDP，可自定义配置修改为UOT。
2.2 转发链场景: 如果链长度超过1，则UOT，否则退化为一级隧道，原生UDP。

升级和维护

Q: 如何备份和恢复配置？

A: 迁移之前，需要确保新机器的操作系统版本, docker docker-compose版本，以及面板域名不要变化。

bash <(curl -sL https://get.zeroforwarder.com/install.sh)

选择5，打包数据
之后停止当前机器的服务，注意: 暂时不要卸载老面板或者重装老面板的系统，确保新面板能够成功启动之后，再卸载老面板

docker-compose down

把打包的数据拷贝到新机器，进入目录执行脚本，选择6进行恢复。不需要全新安装。
如果迁移失败，在老面板机器内，面板目录，使用以下命令恢复老面板：

docker-compose up

获取帮助

如果以上方案无法解决您的问题，请：

1. 查看详细日志：

   sudo journalctl -u zf --since "1 hour ago"

在寻求帮助时，请提供：

• 系统信息（uname -a）
• Zero Forwarder 版本（zf version）
• 错误日志和配置文件
• 详细的问题描述和复现步骤