启动第一个 Zero 节点

本页使用一个仅监听本机、直接出站的配置验证安装结果。它不需要准备远程服务器、UUID 或密码，因此可以先确认 Zero 本身工作正常，再添加真实代理节点。

1. 创建配置

新建 config.json：

{
  "inbounds": [
    {
      "tag": "mixed-in",
      "listen": {
        "address": "127.0.0.1",
        "port": 7890
      },
      "protocol": {
        "type": "mixed"
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": {
        "type": "direct"
      }
    },
    {
      "tag": "block",
      "protocol": {
        "type": "block"
      }
    }
  ],
  "route": {
    "rules": [
      {
        "condition": {
          "type": "domain",
          "values": ["blocked.example"]
        },
        "action": {
          "type": "route",
          "outbound": "block"
        }
      }
    ],
    "final": {
      "type": "route",
      "outbound": "direct"
    }
  }
}

这个 Mixed 入站同时接受 SOCKS5 和 HTTP CONNECT。它只监听 127.0.0.1:7890，不会向局域网公开代理端口。

2. 先校验

Linux/macOS：

./target/release/zero validate config.json

Windows PowerShell：

.\target\release\zero.exe validate .\config.json

成功时会显示：

config valid: 1 inbounds, 2 outbounds, 0 groups, 1 rules

如果校验失败，不要直接启动。根据错误中的字段路径修正配置，或查看配置错误处理。

3. 启动

Linux/macOS：

./target/release/zero run config.json

Windows PowerShell：

.\target\release\zero.exe run .\config.json

Zero 默认以前台进程运行。保持这个终端开启，再打开第二个终端进行验证。

4. 验证代理和状态

通过 Mixed 入站发起一次 SOCKS5 请求：

curl --proxy socks5h://127.0.0.1:7890 https://example.com/

查看运行状态：

./target/release/zero status

Windows：

.\target\release\zero.exe status

CLI 会自动连接本地 IPC。Linux/macOS 默认使用 ~/.zero/control.sock，Windows 默认使用 \\.\pipe\zero-control。

5. 停止

回到运行 Zero 的终端并按 Ctrl+C。生产环境应由 systemd、Windows 服务管理器或其他进程管理器负责启动、停止和崩溃重启。

下一步

• 配置基础：加入真实代理出站和路由。
• 协议配置：选择 VLESS、VMess、Trojan、Shadowsocks、Hysteria2 等协议。
• 运行与观测：查看 flow、事件、日志和策略状态。
• 使用控制 API：为脚本或外部服务启用 HTTP/gRPC。