状态、日志与重启
v1.4.8 已发布交互与输入维护。系统及实例检查保留，正常管理不再重复打印环境检测表。已有外部 WebDAV 工具在主菜单 15 的子菜单选择 8 升级后，重新打开使用新向导。
v1.4.7 已正式发布 15. 外部 WebDAV。历史正式 v1.4.6 尚无此选项；已有主机须显式更新离线管理工具。
安装后在目标 Linux 主机运行 tg2cloud。先选择 Edition，再按菜单名称操作；状态和日志不下载新代码，重启、升级、写入验收和卸载分别确认。
本地管理菜单#
以下 1～14 沿用 v1.4.4 菜单编号；15. 外部 WebDAV 自 v1.4.7 提供，历史正式 v1.4.6 尚无此选项。旧版 v1.4.3 的编号不同，应先升级匹配的离线工具。更新文档不会更新 VPS，也不会自动重启 Bot。
── TG2Cloud 本地管理 ──
1. 安装与升级
2. 查看运行状态
3. 查看运行日志
4. 服务启停管理
5. Bot 用户管理
6. WebDAV 凭据
7. HTTPS 与管理
8. 文件分类设置
9. 异常通知设置
10. 业务就绪检查
11. WebDAV 验收
12. 故障诊断报告
13. 数据备份管理
14. 卸载当前实例
15. 外部 WebDAV
16. 监听管理
0. 退出
选择操作（回车默认 0）:Edition、实际版本、运行状态和安装目录从所选实例读取，不固定示例值。所选 Edition 未安装时，先确认是否进入安装向导；不会因选择 OpenList 就操作 CloudDrive2。
tg2cloud
tg2cloud manage --edition clouddrive2从已审阅的本地源码运行可使用：
python3 /path/to/TG2Cloud/scripts/run_source.py manage状态与日志不下载新代码；1. 安装与升级 核对主实例正式稳定 Release，外部 WebDAV 首次取用与显式升级也只下载校验后的稳定源码。已有公网 / 内网模式保留，不因入口名称不同而转换。
16. 监听管理从 v1.4.10 提供：登录、查看状态、停用监听在子菜单完成，沿用所选 Edition 与安装目录。正式 v1.4.9 仍使用 listen 子命令；手机号／验证码可见、仅两步验证密码隐藏的调整从 v1.4.10 提供。
查看实际运行版本与日志#
v1.4.5 的 2／3／10 页面可停留、刷新和明确返回；1 重新检查／读取，0 或回车返回主菜单。状态用中文分项，停止容器不复用旧健康成功；日志按服务分组，单源失败不遮住另一源。其余次级页面统一标题与对象，通知参数逐行显示，诊断终端与 Markdown 导出分开渲染；原确认与权限不变。旧离线工具需显式升级，按本页当前菜单操作。
2. 查看运行状态 核对所选实例；不能把下载脚本显示的目标版本当成失败后实际运行版本。
3. 查看运行日志 读取近期脱敏结果。分享前仍需自己检查个人信息，不上传原始配置、数据库、备份或 Session。
两个 Edition 的底层只读命令仍有效：
sudo /opt/tg2cloud-clouddrive2/manage.sh status
sudo /opt/tg2cloud-clouddrive2/manage.sh logs
sudo /opt/tg2cloud-clouddrive2/manage.sh checkOpenList 将目录换为 /opt/tg2cloud-openlist。不要用另一 Edition 的路径处理当前实例。
服务启停#
4. 服务启停管理 直接列出启动、停止、重启 Bot 或网关的六个动作；只操作选定容器，需确认。网关重启可能影响管理和外部读取，Bot 重启可能中断任务。
底层脚本存在差异：CloudDrive2 的 manage.sh restart 只重启 Bot；OpenList 的同名命令会重启网关和 Bot，只重启它的 Bot 应使用 restart-bot。优先通过菜单明确选择对象。
重启不安装新版本，也不等于应用新配置，详见升级与配置。
用户、凭据与可选设置#
| 主菜单 | 用途与边界 |
|---|---|
| 5. Bot 用户管理 | 添加、停用或移除可信家人；查看、设置或取消成员配额，不创建个人目录 |
| 6. WebDAV 凭据 | 每项在私有终端确认后显示保存值；不改密或重置管理员 |
| 8. 文件分类设置 | 直接选择不分类、类型、年份、年月或类型与年月，仅影响新任务 |
| 9. 异常通知设置 | 总开关、恢复通知与磁盘阈值，默认关闭，仅通知管理员 |
设置保留锁和 revision 校验，不要求重启 Bot。磁盘提醒阈值 0 跟随原安全线，不用通知设置降低保护。家人的 Bot 授权与外部 WebDAV 只读账号分别管理。
15. 外部 WebDAV 直接沿用当前 Edition 与核验后的实际安装目录，打开安装、检查、启停、配置、升级、卸载和用户管理子菜单；无需额外安装命令。首次尚无工具时先确认，再下载校验正式稳定源码，打开向导不等于启用入口；已有工具核验归属和完整性后离线启动。主安装向导仍不询问或默认启用，不修改 Bot 凭据、目录和数据库，不重启 Bot／网关。子菜单选择 0 返回主菜单，历史独立入口保留兼容，详见统一管理说明。
分类不移动历史文件或修改旧任务目录；通知在 Bot 停止或完全断网时不能保证送达。详细规则见可选功能说明。
两种健康检查的区别#
| 操作 | 含义 | 真写目标 |
|---|---|---|
| 10. 业务就绪检查 | 读取最近 Telegram、目的端、调度和容量观察；过期显示未核实 | 否 |
Bot /doctor、manage.sh check | 诊断 / 基础配置与运行检查，不等于写入能力通过 | 否 |
| 11. WebDAV 验收 | 确认后创建、上传、大小复验并清理随机测试文件 | 是 |
就绪检查不追加网络探测、不绕过 OpenList 冷却、不自动重启。healthy、最近就绪与 TG2CLOUD_DESTINATION=OK 是不同层面的证据。完整流程见真实验收。
tg2cloud naming-preview 仍可独立使用，但不再列在主菜单；Bot 自动命名不受影响。规则与限制见命名指南。
OpenList 认证与限流诊断#
Bot /doctor 显示最近实际探测时间、错误分类和剩余冷却，不把消息刷新时间当成重新检测成功。
| 结果 | 只读探测保护 | 处理 |
|---|---|---|
| 401 | 冷却 5 分钟 | 核对网关专用用户与实际运行配置 |
| 429 | 60、120、240、480、900 秒逐步退避 | 停止高频重试，查看上游与网关限制 |
刷新不绕过冷却；冷却结束不保证服务端已解除限制。显式写入验收是另一项会创建文件的操作，不反复运行来绕过保护。详见WebDAV 排查。
HTTPS、备份与诊断报告#
7. HTTPS 与管理 检查 / 修复当前入口，或显式执行续期 dry-run。内网实例保留原 HTTP 模式，不隐式申请证书。
12. 故障诊断报告 只读汇总白名单版本、资源、状态和最近失败分类；未知项显示“未检查”，不读取原始聊天、文件名或完整凭据。先展示，确认后在本机私密保存，不自动上传。
v1.4.5 诊断补充只读入口结果及认证、权限、冷却、容量和远端冲突的处理建议；不自动修复或重启，历史失败分类不等于当前故障。旧 v1.4.4 工具需升级，见维护说明。
13. 数据备份管理 分别处理实例回退点、实例快照与共享代理备份；快照有服务暂停影响，隔离预检不等于生产恢复。完整范围见备份说明。
安装 / 升级日志分级及验收摘要见升级反馈，不把摘要中未执行项标为通过。
卸载当前实例#
14. 卸载当前实例 只处理所选 Edition，需再次核对完整计划与删除确认，不删除云端文件或另一 Edition 的业务数据。附加入口仍依赖网关时先处理依赖，仅 disable 不等于解除依赖。
最后一套完整卸载后，只有无保留实例、数据 / 备份或附加依赖且归属可核验，才删除 tg2cloud 与受管代码。系统 Docker / Nginx、镜像缓存、锁元数据等不承诺恢复原状。
卸载不是升级步骤；保留数据需使用相应保留模式，见卸载指南。
提交问题前#
记录 Edition、实际版本、操作阶段和第一处错误，先自行脱敏。不要公开 .env、rclone 配置、数据库、Session 或备份，详见安全说明。
v1.5.0：Bot 与管理工具版本核对#
v1.5.0 将 Bot 和宿主 CLI 分开核验：离线工具来自目标正式 Release 的已校验源码，安装提示包含实际 CLI 版本、目标是否一致以及离线命令检查。管理首页显示当前进程版本；工具更新后需退出旧菜单，再运行 tg2cloud。
从 v1.4.11 或更早版本首次升级时，使用下载页中的公网或内网在线入口；旧管理进程不会自行加载新版工具更新逻辑。
升级后可用 tg2cloud --version 查看 CLI，tg2cloud listen --help 检查监听入口；这些命令不执行 Telegram 登录。Bot 的运行代码／版本和 CLI 的可用性分别判定，缺少证据时明确未核实。监听登录兼容在线向导标准输入被重定向的控制终端，2FA 继续隐藏。
用户已提供两台 Linux 的 v1.4.11 基础升级记录，Bot、备份和本机 HTTPS 通过，但 CLI 版本未单独核验、监听登录未完成。真实转存等范围见实机补充，本版修复的实机验收尚未执行。
v1.5.6：日志、凭据与监听诊断加固#
本节说明 v1.5.6 的实现；正式发布进度见本版记录，旧实例须显式更新匹配的 Bot 与离线管理工具，文档更新不会改变 VPS。
- 日志容量：两版 Bot、网关和受管共享代理采用每个容器
json-file、max-size: "10m"、max-file: "3"。Bot 自身文件日志仍按 10 MiB／5 份历史轮转，两者分别占用空间。只对本项目服务配置，不修改宿主daemon.json或清理其他容器。新日志选项需要在后续确认更新、创建相应容器时生效；仅重启旧容器不会套用，已有共享代理须按原 HTTPS 维护流程确认配置更新。外部复用代理继续由其所有者管理。 - 凭据与权限：通过 rclone 官方的标准输入处理密码，不把明文或可逆混淆值放进进程参数；混淆不是加密。先生成权限 600 的临时配置，失败保留旧文件，遇不认识的格式或并发变更停止。保留其他 remote 和自定义选项；不要同时手工编辑运行中的配置。Linux 下，当前用户拥有的 Bot Session、业务库与已有 SQLite 旁文件收紧为 600，既有名称和内容保留；链接、硬链接或归属不明文件拒绝，不自动 chown、删除或重建。
- 监听独立观察：在
tg2cloud的业务就绪页面和故障诊断报告查看。原有五项仍表示 Bot 基础条件，个人监听另列启停、连接、冷却、循环／来源轮询过期与补拉缺口；未启用监听不影响手动转存，异常观察不触发额外登录、探测或服务重启。 - 临时异常与最终失败：报告分别列当前失败任务，以及最近 24 小时本次进程观察到的监听限速／请求异常、WebDAV 探测异常。每类最多保留 64 次，触及容量时标为“至少”；重启后重新计数，不包含 Telethon 内部全部重试日志，也不是历史错误完整审计。当前探测通过并不抹去近期异常，近期异常也不等于任务最终失败。
无新增配置项或数据库迁移。Bot 首页、上传提交策略和现有任务去重不变；修复后的 Linux 原生容器与真实两网关行为仍需在发布后独立验收。
v1.5.7：检查容器日志轮转是否已生效#
v1.5.7 在安装／升级结果和故障诊断报告中只读核对实际容器的日志参数。分别显示 Bot、网关、受管共享 Nginx 和 Certbot；先核验 Compose 实例归属，共享容器还需匹配管理标签。不存在、不可读或归属不明时标记“未核实”，不以模板内容代替运行结果。
项目限额为 json-file 每份不超过10m、最多3份；更小限额也视为已采用。缺少限额会显示“未采用项目轮转限额”，其他日志驱动或自定义大限额单独提示核对。修改 Compose 文件或仅重启不能使旧容器套用新参数，应先确认中断影响，再按原部署方式更新创建相应容器；程序不会为此自动重建、停止服务或清理日志。
这个检查不代表转存验收通过，也不会读取环境变量、命令参数、完整日志或访问其他项目的自定义代理。独立 Compose 实例继续按其原工具维护；旧 v1.5.6 尚无上述自动汇总，已有实例须显式升级。