顶部卡片显示映射数量、已启用的 HTTPS 站点和本地设备状态。连接链路展示域名、VPS 和家庭设备；下方显示两块本地硬盘的可用空间。

• 已连接：本地管理设备最近 75 秒内上传了状态，不等同于所有网站都一定正常。
• 家庭隧道延迟：由 VPS 直接请求家庭探针，确认 frp 通道和本地 Nginx 都能响应。
• 排队中 / 等待本地应用：操作已保存，系统正在配置两端。通常等待几秒后自动刷新。

出现红色或橙色提示时，先按提示排查，再查看操作记录中的具体错误。

1. 打开「域名映射」，点击「新建映射」。
2. 填写未被其他项目使用的完整域名，例如 files.19860717.xyz，不要填写 https:// 或端口。
3. 选择「静态文件目录」，填写实际目录：三星盘使用 /www/nvme-storage/你的目录，SATA 盘使用 /www/storage/你的目录，网站目录使用 /www/wwwroot/你的目录。
4. 目录还不存在时勾选「自动创建」；需要在浏览器中列出文件时，勾选「允许浏览文件列表」。有 index.html 时优先显示首页。
5. 选择 Cloudflare 自动解析，点击「保存并部署」。状态变为「运行中」后，点击域名打开网站。

目录模式适合 HTML、图片、文件下载，不执行 PHP，并会拦截常见脚本和配置文件扩展名。发布前仍应自己确认目录中没有需要保密的文件。

「编辑」更新目标目录或备注；「停用」关闭公网入口，保留配置和数据；「删除」移除本系统生成的配置，保留本地文件、原宝塔站点和 DNS 记录。域名本身要更换时，请新建映射。

1. 先在家里的宝塔创建项目，并确认用局域网地址可以正常打开。
2. 在新建映射中选择「已有网站」。可以从列表选取本地站点，也可以手动填写本地 HTTP 域名和端口。
3. 例如项目在 http://192.168.100.1:1001，填写本地域名 192.168.100.1、HTTP 端口 1001。
4. 填写对外使用的新域名，保存并等待运行。项目仍由原宝塔管理，文件和数据库保持在原位置。

连接的应是网站 HTTP 端口，不能选择 SSH、宝塔面板或软路由管理端口。某些应用还需要在自己的设置中更新公开网址、可信域名或代理设置，避免跳转回局域网地址。

1. 先让映射达到「运行中」，并确认域名已经指向本 VPS。
2. 在该映射的操作栏点击「HTTPS」。系统通过免费证书服务进行域名验证，签发可能需要一两分钟。
3. 签发后域名链接改为 HTTPS，证书后续由 VPS 的定时任务自动续期。

申请失败时，检查 DNS、VPS 的公网 80 端口、Cloudflare 规则是否拦截证书验证。使用橙色云朵代理时，SSL/TLS 模式建议使用 Full (strict)。现有证书任务占用服务时，系统会等待重试；失败信息会显示在映射下方。

HTTPS 失败通常不影响已运行的 HTTP 站点，可以排除问题后再次点击 HTTPS。

延迟表示请求往返时间，单位为毫秒（ms）；带宽实测表示传输速度，单位为 Mbps。这是两个不同指标：低延迟不代表下载一定快，带宽高也不保证响应延迟低。

• 浏览器 → 公网域名：从你当前设备发起 3 次 HTTPS 请求，取中位数，包含可能的 CDN、HTTPS 与服务处理开销，不能单独分离出 CDN 到 VPS 的延迟。
• VPS ↔ 家庭隧道：VPS 请求家庭 Nginx 探针，3 次 HTTP 往返取中位数。每分钟自动检测，不下载大文件。
• 访问本地资源往返估算：将两段往返相加，帮助判断大致响应水平；实际页面还取决于程序、数据库和资源数量。这里不是纯 ICMP ping。
• VPS → 当前浏览器：通过管理域名下载最多 8 MiB 的随机样本，反映你当前访问路径的实际下载表现。
• 家庭上传 → VPS：通过 frp 读取最多 16 MiB 的本地样本，反映家庭上传、隧道、VPS 接收能力共同形成的实际吞吐。

点击「开始测速」才进行带宽测试，两段顺序执行以减少相互干扰，一次约使用最多 24 MiB 样本流量。网速很慢时会提前结束并使用已收到的数据估算；短时测速有波动，不代表运营商承诺的套餐速率。

实际传输通常会低于理论值。远程读取家里文件的最终速度，还会受到家庭上行、VPS 线路和访客下载能力中较慢的一段限制。

这里显示最近 50 条账户、配置、部署和手动测速记录，按时间倒序排列。你可以用域名和时间找到刚提交的操作。

• 「创建 / 更新映射」表示请求已保存，之后还需要看到「操作完成」。
• 「部署失败」包含两端配置、目录、DNS 或证书的具体错误。修复后编辑并重新保存，或重新点击 HTTPS。
• 密码、API Token、设备密钥不会作为正常操作记录回显。

1. Cloudflare → 头像 → My Profile → API Tokens → Create Token，选择 Edit zone DNS。
2. 只授权要管理的区域，权限为 Zone / DNS / Edit；在区域 Overview 中复制 Zone ID。
3. 在「系统设置」填入 Token 与 Zone ID，点击「验证并保存」。留空 Token 会保留旧值，已保存的 Token 不回显。
4. 以后新建映射选择 Cloudflare，系统自动创建或更新对应 A 记录至 VPS，无需手动填写端口。

如果不填 Zone ID，还需要 Zone Read 权限以查询区域。自动解析只会操作你指定域名的 A 记录，不会自动清理原有 AAAA、CNAME 等记录；存在冲突时请先到 Cloudflare 检查。

账户密码可在此修改，长度至少 8 个字符。修改成功后会使已有登录状态失效，需要重新登录。

Cloudflare 官方 Token 设置说明 ↗

本地设备显示离线

1. 确认迷你主机通电、iStoreOS 能正常上网，局域网内能打开软路由管理页。
2. 设备管理连接使用 VPS 的 443 端口；检查家庭网络或代理是否阻止了该连接。
3. 如仍离线，在软路由 SSH 中执行下面的管理设备服务重启命令，等待约 20 秒刷新后台。

/etc/init.d/home-frp-agent restart

设备在线，但家庭隧道异常 / 网站返回 502

1. 软路由 → 服务 → frp 客户端，确认服务运行，服务器地址正确，VPS 的 7000/TCP 允许连接。
2. 确认本地宝塔容器与网站正常运行，原局域网网站可以访问。
3. 必要时重启 frpc；在 VPS 上检查 frps 服务。重启这些服务会短暂中断家庭站点访问。

# 软路由 SSH
/etc/init.d/frpc restart
# VPS SSH
systemctl status frps --no-pager
systemctl restart frps

控制台提示网络连接中断

先检查当前设备网络、刷新页面；如果只在某个网络异常，换网络对比。若所有网络都打不开，检查 VPS、域名解析、HTTPS 证书与 Cloudflare 状态。后台可访问但检测数据长时间不更新时，可在 VPS 上检查后台服务：

systemctl status home-frp-manager home-frp-worker --no-pager
systemctl restart home-frp-manager home-frp-worker

目录不存在 / 磁盘未挂载 / 403

在本地宝塔文件管理中确认目录存在；不要把 VPS 上的路径当成本地路径。目录不存在可勾选自动创建。三星盘必须已挂载；需要目录列表时勾选「允许浏览文件列表」。若仍然 403，检查宝塔内的文件访问权限。

域名已存在 / 配置冲突

系统不会覆盖其他项目的站点。换一个新域名，或在「已有网站」模式选择已经创建的本地项目；不要直接删除其他项目配置。

Cloudflare 授权失败 / 域名仍指向旧地址

确认 Token 有目标区域的 DNS 编辑权限、Zone ID 对应同一区域，域名属于这个区域。检查是否存在 CNAME 或旧 AAAA 记录，以及是否仍在 DNS 缓存期。

速度偏慢，但连接正常

停止其他上传下载后再测；比较两段带宽：家庭上传慢时检查宽带上行与软路由负载，VPS 到浏览器慢时检查 VPS 出口、线路和当前网络。延迟高但带宽正常，多与线路距离、拥塞或排队有关。