Sing-box 开源项目安装与使用指南

目录结构及介绍

在克隆或下载Sing-box项目之后，你会看到如下的主要目录结构：

sing-box/
│   LICENSE
│   README.md
│   
├───configs           # 配置文件示例存放位置
│       example.toml  # 示例配置文件
│       
├───internal          # 内部实现细节代码
│       
├───pkg               # 包含各种功能包, 如网络逻辑等
│       
├───proxy             # 各种网络类型的代码实现
│       
├───runtime           # 运行时相关代码
│       
└── cmd               # 命令行工具及其定义
        sing-box.go   # 主命令入口文件

• LICENSE 和 README.md: 许可证信息和项目简介。
• configs/: 存放配置文件的地方，其中 example.toml 是一个配置模板。
• internal/ 和 pkg/: 分别存储了内部实现和封装的各种功能包。
• proxy/: 实现不同类型网络机制的代码所在。
• runtime/: 执行相关的运行时控制代码。
• cmd/: 此处的 sing-box.go 文件是Sing-box的核心执行脚本。

启动文件介绍

Sing-box 的主执行文件位于 cmd/ 目录下，具体为 sing-box.go。这是应用程序的实际入口点，通过调用内部的初始化函数和命令行解析器来设置并运行Sing-box服务。

当你在命令行中输入 ./sing-box --version 或者 sing-box --version（取决于你的系统环境），它将显示当前Sing-box版本号和构建日期，这可以帮助确认是否成功安装正确的版本。

此外，sing-box 支持多种参数，这些可以通过执行 sing-box --help 来获取详细帮助文档，指导如何进行操作。

配置文件介绍

Sing-box 使用 TOML 格式作为其配置文件的基础。默认情况下，Sing-box 将尝试从以下路径之一加载配置文件：.config/sing-box/config.toml, $SING_BOX_HOME/config.toml, ./config.toml （按此顺序）。

configs/example.toml 提供了一个完整的示例配置文件，包含了所有可能的选项和其默认值。以下是部分核心配置项说明：

General 部分

• log_level: 设置日志记录等级，默认为 "info"。
• inbounds: 定义入站连接规则，可以设定监听地址、端口以及使用的网络类型。
• outbounds: 出站连接规则，包括目标服务器的信息、协议和加密方式。

Network Settings

• type: 指定网络类型，例如 "ss", "vless" 等。
• server: 网络服务器的IP地址或域名。
• port: 网络服务器的监听端口。

Routing 规则

这部分允许设置复杂的流量路由策略，包括直连、网络或者阻断特定流量的能力。

通过深入理解上述关键元素，你可以灵活地自定义网络行为，满足个人需求和优化性能体验。