Clash 启动脚本报错怎么逐项排查

Clash 启动脚本报错时，第一步应检查日志输出路径是否正确。若脚本默认输出到 `/tmp/clash.log`，但系统临时目录被清理或权限受限，会导致日志无法写入，进而引发启动失败。可通过 `echo $TMPDIR` 查看当前临时目录位置，确认其可读写；若路径无效，手动指定如 `export TMPDIR=/home/user/.clash/tmp`，并在脚本开头添加 `mkdir -p "$TMPDIR"` 确保目录存在。

第二步验证配置文件路径是否真实存在且格式正确。常见错误是将 `config.yaml` 误写为 `config.yml`，或路径中包含空格、中文字符。使用 `ls -l /path/to/config.yaml` 确认文件存在，并用 `yamllint config.yaml` 检查语法。例如，若配置中出现 `proxies: []` 而非 `proxies: [ ]`，YAML 解析器会直接报错，导致启动中断。

第三步排查环境变量缺失。许多脚本依赖 `CLASH_CONFIG` 或 `CLASH_PORT` 等变量。若未在启动前设置，运行 `env | grep CLASH` 可发现变量为空。建议在脚本开头显式声明：`export CLASH_CONFIG="/home/user/clash/config.yaml"`，并用 `set -u` 开启未定义变量报错机制，强制暴露潜在问题。

第四步关注端口占用情况。若脚本尝试绑定 7890 端口，而已有进程占用，会触发 `Address already in use` 错误。使用 `lsof -i :7890` 查看占用进程，若为旧的 Clash 进程，执行 `kill $(lsof -t -i :7890)` 强制终止。也可在脚本中加入判断：`if lsof -i :7890 > /dev/null; then echo "Port 7890 occupied"; exit 1; fi`。

第五步检查依赖工具版本兼容性。某些脚本调用 `curl`、`jq`、`sed` 等命令，若系统默认版本过低（如 `jq` < 1.6），可能因语法不支持出错。通过 `curl --version` 和 `jq --version` 确认版本，必要时使用 `apt install jq=1.6-2` 回滚至稳定版本。此外，若脚本使用 `sed -r`，而系统默认为 `sed -E`，需统一替换为 `-E` 或使用 `sed -E` 明确指定。 延伸阅读：PikPak 怎么指定本地下载路径。 延伸阅读：AI 简历怎么写项目经历。

第六步逐行调试脚本逻辑。使用 `bash -x script.sh` 启动脚本，输出每行执行过程。例如，当遇到 `source ~/.bashrc` 失败时，`-x` 输出会显示 `source: line 34: cannot find file`，从而定位到 `.bashrc` 中某条路径错误。此时可将该行改为 `source /home/user/.bashrc` 并注释掉原行，再重新测试。

第七步结合具体案例验证修复效果。例如，某用户在使用 PikPak 时，希望指定本地下载路径为 `/data/pikpak/downloads`，但脚本始终将文件保存在默认路径。通过查看 PikPak 的 API 文档，发现需在请求头中加入 `X-PikPak-Download-Path: /data/pikpak/downloads`，于是修改脚本中 `curl` 请求部分，加入该头部字段，问题解决。类似地，在撰写 AI 简历项目经历时，若仅写“参与开发代理工具”，则信息模糊；应明确写成“基于 Clash 配置实现自动路由切换，支持 5 类协议，日均处理流量 1.2TB”，增强可信度与技术细节。

最后，建立脚本健康检查清单。每次更新配置或环境后，按顺序执行：1. 日志路径可用性；2. 配置文件语法；3. 环境变量设定；4. 端口占用检测；5. 工具版本校验；6. 依赖项加载；7. 执行轨迹追踪。此清单可存为 `check_clash_health.sh`，定期运行，提前拦截 90% 以上启动异常。