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

Clash 启动脚本报错时，第一步应检查日志输出路径是否正确。默认情况下，Clash 会将日志写入 `~/.config/clash/log` 目录，若该路径不存在或权限不足，脚本将无法启动。可执行 `ls -la ~/.config/clash/` 确认目录是否存在，若无则手动创建：`mkdir -p ~/.config/clash/log`，再赋予读写权限：`chmod 755 ~/.config/clash/log`。若日志文件生成失败，系统会静默退出，此时需通过 `journalctl -u clash.service` 或直接运行脚本时附加 `--log-level=debug` 参数获取详细输出。

第二步是验证配置文件路径与格式。常见错误如 `config.yaml` 文件路径写错，或使用了非 UTF-8 编码。例如，若配置文件路径为 `/opt/clash/config.yaml`，但实际文件位于 `/opt/clash/conf.yaml`，启动脚本将因找不到文件报错。可用 `cat -A /opt/clash/config.yaml` 查看隐藏字符，确保无不可见的换行符或制表符。推荐使用 VS Code 打开文件并设置编码为 UTF-8，避免因编码问题导致解析失败。

第三步检查环境变量是否被正确加载。某些脚本依赖 `CLASH_CONFIG_PATH` 或 `CLASH_PORT` 等变量。若在 `~/.bashrc` 中设置了 `export CLASH_CONFIG_PATH=/path/to/config.yaml`，但未执行 `source ~/.bashrc`，脚本运行时仍会使用默认路径。可通过 `echo $CLASH_CONFIG_PATH` 验证变量是否生效。若为空，需重新加载环境或在脚本开头显式声明：`export CLASH_CONFIG_PATH="/opt/clash/config.yaml"`。

第四步排查端口占用问题。若 7890 端口已被其他进程占用，Clash 会报错“Address already in use”。使用 `lsof -i :7890` 可快速定位占用进程，如返回 `PID 1234`，执行 `kill 1234` 强制释放。若需保留原服务，可在配置中修改端口为 7891，或在脚本中添加 `--port=7891` 参数。对于自动化部署场景，建议使用 `fuser -k 7890/tcp` 实现一键释放。

第五步分析脚本自身语法错误。以 Bash 脚本为例，若使用 `if [ "$var" = "true" ]` 但缺少空格，将触发语法错误。可运行 `bash -n script.sh` 进行语法检查，此命令不执行脚本，仅校验语法。若发现 `line 15: syntax error near unexpected token 'fi'`，说明条件结构不完整，需补全 `fi` 并确保每个 `if` 都有对应的结束标记。

第六步关注依赖组件版本兼容性。例如，Clash Core v6.12.0 要求 Go 1.19 以上版本，若系统安装的是 1.16，则启动失败且无明确提示。可通过 `go version` 查看当前版本，若低于要求，需从官方下载对应版本并替换 `~/go/bin/go`。在生产环境中，建议使用 `docker run --rm -v /path:/config clash-cli:latest` 来规避本地环境差异，容器内自带完整依赖。

最后，所有排查动作都应记录到一个调试日志表中。例如，在 `debug.log` 中逐项记录：时间戳、错误信息、修复措施、验证结果。当遇到“无法连接代理”这类模糊错误时，该表格能快速回溯历史操作。简历里的项目数据怎么核实；校园经历在简历里怎么写才有分量——这些看似无关的问题，实则与故障排查逻辑一致：每一项结论都需有可验证的数据支撑，每一步行动都要留下可追溯的痕迹。只有将排查过程标准化、文档化，才能真正实现从“试错”到“可控”的转变。