文档中心

找到您需要的所有信息,从入门指南到高级配置,我们都为您准备好了。

版本升级与兼容性

版本命名规则

FRP使用语义化版本命名:主版本.次版本.修订号

  • 主版本号:不兼容的API变更
  • 次版本号:向后兼容的功能性新增
  • 修订号:向后兼容的问题修正

升级最佳实践

安全升级FRP的步骤:

  1. 备份当前配置文件
  2. 查阅新版本的更新日志
  3. 先在测试环境验证
  4. 升级服务端(frps)
  5. 升级各个客户端(frpc)
# 停止当前服务
systemctl stop frps

# 备份配置和二进制文件
cp /usr/bin/frps /usr/bin/frps.bak
cp /etc/frps/frps.ini /etc/frps/frps.ini.bak

# 替换二进制文件
cp ./frps /usr/bin/frps

# 重启服务
systemctl start frps

版本兼容性问题

常见的兼容性问题和解决方案:

  • 0.37.0版本后配置格式变化:检查新的配置语法
  • 0.34.0版本后的鉴权方式变化:更新鉴权设置
  • 0.29.0版本后的插件系统变化:适配新的插件机制

回滚策略

当升级出现问题时的回滚步骤:

  1. 停止新版本服务
  2. 恢复备份的二进制文件
  3. 恢复备份的配置文件
  4. 重启服务
  5. 通知所有客户端回滚