30个实用选项快速掌握：sing-box命令行完全指南
你是否还在为记不住sing-box的命令参数而烦恼？本文整理了sing-box的核心命令行选项，通过实例讲解帮助你快速上手，轻松配置代理服务。读完本文你将能够：掌握常用命令组合、解决常见配置问题、优化代理性能。
基础命令结构
sing-box采用命令+选项的基本结构，通用语法如下：
sing-box [全局选项] 命令 [命令选项] [参数]
核心命令定义在cmd/sing-box/main.go中，通过Cobra框架实现命令解析。
全局选项
| 选项 | 说明 | 示例 |
|---|---|---|
-c, --config | 指定配置文件路径 | sing-box run -c config.json |
-d, --directory | 设置工作目录 | sing-box run -d /etc/sing-box |
-l, --log-level | 设置日志级别 | sing-box run -l debug |
--disable-color | 禁用彩色日志 | sing-box run --disable-color |
日志级别控制在log/level.go中实现，支持debug、info、warn、error四个等级。
核心命令详解
run命令
启动sing-box服务的主要命令，语法：
sing-box run [选项]
关键选项：
--test：测试配置文件有效性--watch-config：监听配置文件变化自动重启
配置文件格式定义在common/settings/目录中，支持JSON、YAML等格式。
version命令
查看当前版本信息：
sing-box version
版本信息定义在constant/version.go中，包含编译时间、Git提交等信息。
help命令
获取命令帮助：
sing-box help [命令]
完整帮助文档可参考docs/configuration/目录下的官方文档。
高级选项
网络优化选项
| 选项 | 说明 |
|---|---|
--tcp-fast-open | 启用TCP快速打开 |
--udp-timeout | 设置UDP超时时间 |
--sniffing | 启用流量探测 |
这些选项对应的实现代码位于common/network.go中。
安全相关选项
--disable-udp：禁用UDP支持--tls-cert：指定TLS证书文件--tls-key：指定TLS私钥文件
TLS相关实现位于tls/目录，支持自动证书生成和ACME协议。
实用命令示例
快速启动
sing-box run -c config.json -l info
测试配置文件
sing-box run -c config.json --test
查看版本信息
sing-box version --long
常见问题解决
配置文件错误
使用--test选项检查配置文件语法：
sing-box run -c config.json --test
配置验证逻辑在common/settings/system_proxy.go中实现。
端口占用问题
通过--inbound-addr选项指定端口：
sing-box run --inbound-addr :1080
总结与展望
本文介绍了sing-box的核心命令行选项，涵盖基础用法、高级配置和实用示例。完整的命令文档可通过sing-box help查看，更多高级功能请参考docs/目录下的官方文档。建议收藏本文作为日常参考，关注项目更新获取最新功能。
下一篇我们将深入探讨sing-box的配置文件编写，敬请期待！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
