---
title: FRPC 集成与启动恢复设计
type: decision
permalink: main/projects/4f53c06a-c6c3-40ec-b2fc-5f019ea45fc0/frpc-集成与启动恢复设计
stable_id: fa66c797-a786-4966-8cb1-2eff40e3dc4e
scope: project
project_id: 4f53c06a-c6c3-40ec-b2fc-5f019ea45fc0
memory_type: decision
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T14:54:47.083173+00:00'
updated_at: '2026-09-23T14:54:47.083232+00:00'
tags:
- decision
- frpc
- startup
- configuration
- ui
---

- FRPC 固定使用官方 linux_arm64 v0.70.1，默认禁用；只有 enabled 与 auto_start 同时为 true 才开机启动。
- 配置存于现有应用 JSON 的 frpc 节点，并生成 /home/root/frpc.toml（0600）；二进制、PID、日志分别为 /home/root/frpc、frpc.pid、frpc.log。
- 禁用状态仍允许编辑保存；只有启动、自启或更新运行中实例时执行可运行配置校验。
- 生成配置强制 loginFailExit = false，保证移动数据/DNS 尚未就绪时 FRPC 保持进程并自动重试；手动停止语义不变。
- OTA 将 frpc 暂存于 /home/root/www/frpc，后端首次启动通过 frpc.new 原子安装，避免小容量 userdata 同时保留两份大文件。
- 管理页面分为运行控制、连接配置、映射规则、运行日志四个分页；连接和规则独立保存，规则开关横向显示。