XIU2/SNIProxy

以下命令仅为示例，版本号和文件名请前往 Releases 查看。

# 如果是第一次使用，则建议创建新文件夹（后续更新时，跳过该步骤）
mkdir sniproxy

# 进入文件夹（后续更新，只需要从这里重复下面的下载、解压命令即可）
cd sniproxy

# 下载 sniproxy 压缩包（这个地址是始终指向最新版本，可自行根据需求替换 URL 末尾的 [文件名]）
wget -N https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# 如果你是在国内服务器上下载，那么请使用下面这几个镜像加速：
# wget -N https://wget.la/https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# wget -N https://ghfast.top/https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# wget -N https://ghproxy.it/https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# wget -N https://gh-proxy.org/https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# wget -N https://cdn.gh-proxy.org/https://github.com/XIU2/SNIProxy/releases/latest/download/sniproxy_linux_amd64.tar.gz
# 如果下载失败的话，尝试删除 -N 参数（如果是为了更新，则记得提前删除旧压缩包 rm sniproxy_linux_amd64.tar.gz ）

# 解压（不需要删除旧文件，会直接覆盖，自行根据需求替换 文件名）
tar -zxf sniproxy_linux_amd64.tar.gz

# 赋予执行权限
chmod +x sniproxy

# 编辑配置文件（根据下面的 配置文件说明 来自定义配置内容并保存(按下 Ctrl+X 然后再按 2 下回车)
nano config.yaml

# 运行（不带参数）
./sniproxy

# 运行（带参数示例）
./sniproxy -c "config.yaml"

# 后台运行（带参数示例）
nohup ./sniproxy -c "config.yaml" > "sni.log" 2>&1 &

另外，强烈建议顺便提高一下 系统文件句柄数上限，避免遇到报错 too many open files

另外，如果你希望 开机启动、守护进程(异常退出自动恢复)、后台运行、方便管理 等，那么可以将其 注册为系统服务。

下载

下载已编译好的可执行文件并解压：

1. Github Releases
2. 蓝奏云(密码:xiu2)

配置

找到配置文件 config.yaml 右键菜单 - 打开方式 - 记事本。

根据下面的 配置文件说明 来自定义配置内容并保存。

运行

双击运行 sniproxy.exe 文件。

或者在 CMD 命令行中进入软件所在目录并运行 sniproxy.exe：

# CMD 命令行中进入解压后的 sniproxy 程序所在目录（记得修改下面示例路径）
cd /d C:\xxx\sniproxy

# 运行（不带参数）
sniproxy.exe

# 运行（带参数示例）
sniproxy.exe -c "config.yaml"

下载已编译好的可执行文件并解压：

1. Github Releases
2. 蓝奏云(密码:xiu2)

# 通过命令行进入 sniproxy 压缩包所在目录（记得修改下面示例路径）
cd /xxx/xxx

# 解压（不需要删除旧文件，会直接覆盖，自行根据需求替换 文件名）
tar -zxf sniproxy_linux_amd64.tar.gz

# 赋予执行权限
chmod a+x sniproxy

# 编辑配置文件（根据下面的 配置文件说明 来自定义配置内容并保存(按下 Contrl+X 然后再按 2 下回车)
nano config.yaml

# 运行（不带参数）
./sniproxy

# 运行（带参数示例）
./sniproxy -c "config.yaml"

注意： 配置文件是 YAML 格式，即按照缩进（即每行前面的空格数量）来确定层级关系的，因此不懂的话请按照默认配置文件内示例的格式为准，其中 # 的是注释（会被程序忽略），不需要的配置可以注释掉。

目前配置文件中的配置项没几个，分别为：

# 监听端口（注意需要引号），常见示例如下：
# ":443"            省略 IP 只写端口，代表监听本机所有 IPv4+IPv6 地址的 443 端口
# "0.0.0.0:443"     代表监听本机所有 IPv4 地址的 443 端口
# "127.0.0.1:443"   代表监听本机本地 IPv4 地址的 443 端口（只有本机可访问）
# "[::]:443"        代表监听本机所有 IPv6 地址的 443 端口
# "[::1]:443"       代表监听本机本地 IPv6 地址的 443 端口（只有本机可访问）
# 上面示例中的 IP 地址也可以换成例如你的外网 IP，这样的话就只能从该外网 IP 访问了
listen_addr: ":443"
# 可选：下面这个的作用是用来将传入的 HTTP 重定向为 HTTPS（固定的 443 端口和上面配置无关），如果没写将不监听及处理 HTTP 连接
listen_addr_http: ":80"


# 可选：启用 Socks5 前置代理
# （启用前：访客 <=> SNIProxy <=> 目标网站
# （启用后：访客 <=> SNIProxy <=> Socks5 <=> 目标网站
# （比如可以套 WARP，那样就变成：访客 <=> SNIProxy <=> WARP <=> 目标网站
enable_socks5: true
# 可选：配置 Socks5 代理地址
socks_addr: 127.0.0.1:40000
# 可选：配置 Socks5 代理的账号和密码（如果有的话）
socks_username: admin
socks_password: abc123

# 二选一：允许所有域名（开启后会忽略下面的 rules 列表，二选一）
allow_all_hosts: true

# 二选一：仅允许指定域名（和上面的 allow_all_hosts 二选一）
# 指定域名后，则代表允许 域名自身 及其 所有子域名 访问服务（以下方两个为例，√ 代表允许，× 代表阻止）
# 如果有非允许的域名请求访问，日志将显示为红色醒目的（这样可以检查是否泄露或被扫描了）：
# 2025/06/16 10:44:55 域名 xxx 不在允许规则中, 忽略(且会注明是来自 http 或 https)...
rules:
  - example.com #    example.com  √ 、a.example.com  √ 、a.a.example.com  √
  - b.example2.com # example2.com × 、b.example2.com √ 、c.b.example2.com √

一些示例：

1. 允许所有域名访问

listen_addr: ":443"
listen_addr_http: ":80"

allow_all_hosts: true

注意，开启 allow_all_hosts 时，可能会被他人扫描到而滥用，请悉知！
建议做一些限制，例如只使用 IPv6（"[::]:443"）或防火墙限制 443 端口的可访问 IP。

2. 仅允许指定域名

listen_addr: ":443"
listen_addr_http: ":80"

rules:
  - example.com
  - b.example2.com

3. 允许所有域名访问 + 启用前置代理

listen_addr: ":443"
listen_addr_http: ":80"

enable_socks5: true
socks_addr: 127.0.0.1:40000

allow_all_hosts: true

4. 仅允许指定域名 + 启用前置代理 + 代理账号密码

listen_addr: ":443"
listen_addr_http: ":80"

enable_socks5: true
socks_addr: 127.0.0.1:40000
socks_username: admin
socks_password: abc123

rules:
  - example.com
  - b.example2.com

新建一个空的名叫 sniproxy 的系统服务配置文件：

nano /etc/systemd/system/sniproxy.service

修改以下内容后（ExecStart= 后面的程序路径、参数）后粘贴进文件内：

[Unit]
Description=SNI Proxy
After=network.target

[Service]
ExecStart=/home/sniproxy/sniproxy -c /home/sniproxy/config.yaml -l /home/sniproxy/sni.log
Restart=on-failure

[Install]
WantedBy=multi-user.target

如果你需要详细日志（调试模式），那么可以加上 -d 运行参数到 ExecStart=... 行末尾（注意加上空格分隔）。

其中 Restart=on-failure 表示，当程序非正常退出时，会自动恢复启动，也就是常说的守护进程。

设置 sniproxy 开机启动并立即启动：

# 启用该系统服务 并 允许开机启动
systemctl enable sniproxy

# 立即启动
systemctl start sniproxy

其他可能会用到的命令：

# 停止
systemctl stop sniproxy

# 重启
systemctl restart sniproxy

# 查看运行状态
systemctl status sniproxy

# 查看完整日志
cat /home/sniproxy/sni.log

# 实时监听日志（会实时显示最新日志内容）
tail -f /home/sniproxy/sni.log

# 如果你修改了 /etc/systemd/system/sniproxy.service 配置文件，那么需要先重载配置后才能启动/重启 sniproxy 服务
systemctl daemon-reload

首先需要清楚，SNIProxy 是通过 IPv4 还是 IPv6 地址转发流量给目标域名源服务器，和你是通过 IPv4 还是 IPv6 访问 SNIProxy 服务无关，"你 与 SNIProxy" 和 "SNIProxy 与 源服务器" 这两个环节是独立的，互不影响的。

因为 SNIProxy 的 DNS 解析环节是交由系统 DNS 服务处理的，因此对于 SNIProxy 是通过 IPv4 还是 IPv6 地址转发流量给目标域名源服务器，则取决于：

1. 运行 SNIProxy 的服务器是否有 IPv4 或 IPv6 地址（或都有，也就是双栈服务器）
2. 运行 SNIProxy 的服务器当前系统配置的 DNS 优先级是 IPv4 优先还是 IPv6 优先（一般默认都是 IPv6 优先）
3. 该目标域名解析记录中是否有 IPv4 或 IPv6 地址（也就是 A 和 AAAA 记录）

即，如果你的服务器有 IPv6 地址，且系统为默认的 IPv6 优先，那么无论你是通过 IPv4 还是 IPv6 访问的 SNIProxy 服务器，只要该域名有 IPv6 解析地址，那么 SNIProxy 就会通过 IPv6 转发流量给目标域名源服务器。

访问 example.com <=IPv4=> SNIProxy <=优先 IPv6=> 系统 DNS 解析获得该域名的 IP 地址  <=IPv6=> 源站(example.com)

访问 example.com <=IPv6=> SNIProxy <=优先 IPv6=> 系统 DNS 解析获得该域名的 IP 地址  <=IPv6=> 源站(example.com)

假如目标域名解析只有 IPv6 地址，你本地只有 IPv4 地址，但你的服务器有 IPv4+IPv6 地址，那么你就可以通过 IPv4 来访问 SNIProxy，然后 SNIProxy 通过 IPv6 访问目标域名源服务器。

访问 example.com(仅 IPv4) <=IPv4=> SNIProxy(支持 IPv4+IPv6)  <=IPv6=> 源站(example.com 仅 IPv6)

关于这个系统 DNS 服务的 IPv4 IPv6 优先级是可以调的（以下为将默认的 IPv6 优先改为 IPv4 优先）：

打开并编辑文件（你也可以使用 vim 来编辑）：

nano /etc/gai.conf

找到以下行：

#precedence ::ffff:0:0/96  100

去掉改行行首的 # 注释符号，使其变为：

如果没有找到的话，可以直接在文件末尾另起一行写上下面这行代码。

precedence ::ffff:0:0/96  100

按下 Ctrl+O 并回车保存文件，然后再按下 Ctrl+X 退出当前的 nano 编辑器。

此时随便 ping 一个同时拥有 IPv4 及 IPv6 地址的域名，看一下结果是不是 IPv4 地址。

另外，修改系统 DNS 优先级后，可能需要清理服务器的 DNS 缓存并重启 SNIProxy 服务。

Linux 系统下，一些人可能会遇到报错（日志如下）：

接受连接请求时出错: accept tcp [::]:443: accept4: too many open files

这是因为系统的文件句柄数耗尽了（默认 1024），提高系统文件句柄数上限可有效缓解该问题（不能完全解决，因为理论上，当打开文件、连接等等足够多时，迟早会耗尽，一般来说不管是做代理还是做网站，这个操作都是必须的）。

• 临时提高（重启后恢复为 1024）

ulimit -n 65535

• 永久提高（重启后依然为 65535，当然打开文件后手动删除就恢复了）

echo "* soft nofile 65535
* hard nofile 65535
root soft nofile 65535
root hard nofile 65535" >> /etc/security/limits.conf

执行以上命令后，需要重启 SNIProxy 来使其生效，如果还不行请尝试重启系统。

systemctl restart sniproxy

为了方便，我是在编译的时候将版本号写入代码中的 version 变量，因此你手动编译时，需要像下面这样在 go build 命令后面加上 -ldflags 参数来指定版本号：

go build -ldflags "-s -w -X main.version=v1.0.7"
# 在 SNIProxy 目录中通过命令行（例如 CMD、Bat 脚本）运行该命令，即可编译一个可在和当前设备同样系统、位数、架构的环境下运行的二进制程序（Go 会自动检测你的系统位数、架构）且版本号为 v1.0.7

如果想要在 Windows 64位系统下编译其他系统、架构、位数，那么需要指定 GOOS 和 GOARCH 变量。

例如在 Windows 系统下编译一个适用于 Linux 系统 amd 架构 64 位的二进制程序：

SET GOOS=linux
SET GOARCH=amd64
go build -ldflags "-s -w -X main.version=v1.0.7"

例如在 Linux 系统下编译一个适用于 Windows 系统 amd 架构 32 位的二进制程序：

GOOS=windows
GOARCH=386
go build -ldflags "-s -w -X main.version=v1.0.7"

可以运行 go tool dist list 来查看当前 Go 版本支持编译哪些组合。

当然，为了方便批量编译，我会专门指定一个变量为版本号，后续编译直接调用该版本号变量即可。
同时，批量编译的话，还需要分开放到不同文件夹才行（或者文件名不同），需要加上 -o 参数指定。

:: Windows 系统下是这样：
SET version=v1.0.7
SET GOOS=linux
SET GOARCH=amd64
go build -o Releases\sniproxy_linux_amd64\sniproxy -ldflags "-s -w -X main.version=%version%"

# Linux 系统下是这样：
version=v1.0.7
GOOS=windows
GOARCH=386
go build -o Releases/sniproxy_windows_386/sniproxy.exe -ldflags "-s -w -X main.version=${version}"