3. 安装、启动与验证#

本章只讲用户视角：如何准备配置、在 Link1 App 中导入和应用、直接运行内核时如何验证配置、如何确认代理可用。

推荐方式：用 Link1 App 管理#

普通用户建议通过 Link1 App 完成以下流程：

1. 新建配置档案。

1. 粘贴 YAML、导入本地文件，或填写订阅地址。

1. 点击校验，确认没有字段错误或引用错误。

1. 应用配置，等待内核启动完成。

1. 在 App 首页确认运行状态、当前模式、实时速率和日志摘要。

1. 打开系统代理、TUN 或路由器模式，让流量进入 Link1。

1. 用连接列表、策略组和日志确认流量按预期转发。

App 会自动处理内部管理通道、状态同步和页面展示；用户通常不需要手写额外管理配置。

配置文件位置#

默认配置文件名是 config.yaml。如果你直接运行内核，可以用 -f 指定：

spark -f /path/to/config.yaml

工作目录用 -d 指定：

spark -d /path/to/workdir -f /path/to/config.yaml

实际影响：

• 相对路径会按配置文件所在目录或工作目录解析。

• provider 缓存、状态库、Fake-IP 持久化、订阅下载文件通常和工作目录有关。

• 路由器部署时建议固定工作目录，避免重启后相对路径变化。

• 如果使用 App，工作目录一般由 App 管理，你只需要关注配置档案本身。

用户常用命令行参数#

这些参数主要用于排障、路由器部署或开发调试。桌面用户优先使用 Link1 App 的配置导入和校验按钮。

第一步：写最小配置#

mixed-port: 7890
mode: rule
log-level: info
allow-lan: false

proxies:
  - name: example-socks
    type: socks5
    server: 127.0.0.1
    port: 1080
    udp: true

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - example-socks
      - DIRECT

rules:
  - MATCH,PROXY

如果你暂时没有上游代理，也可以只用直连验证内核能启动：

mixed-port: 7890
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

第二步：验证配置#

在 App 里点击“校验配置”。如果直接运行内核：

spark -f config.yaml -t

如果配置错误，Link1 会尽量告诉你路径，例如：

compile config "config.yaml": proxies[0].server is empty

读法：

• proxies[0]：proxies 列表里的第 1 个节点。

• .server is empty：这个节点缺少 server。

常见错误和含义：

第三步：启动 Link1#

在 App 中点击启动或应用配置。直接运行内核时：

spark -d . -f config.yaml

启动成功不等于代理已经可用，还要确认流量真的进入 Link1。

第四步：让客户端连接 Link1#

浏览器或系统代理#

填：

HTTP 代理：127.0.0.1:7890
HTTPS 代理：127.0.0.1:7890
SOCKS5 代理：127.0.0.1:7890

mixed-port 同时接受 HTTP proxy 和 SOCKS5。推荐第一次使用时只设置浏览器代理，避免系统全局代理影响其他应用。

curl 验证#

curl -x http://127.0.0.1:7890 https://www.example.com/

如果要验证 Cloudflare WARP：

curl -x http://127.0.0.1:7890 https://www.cloudflare.com/cdn-cgi/trace

不要把 --noproxy '*' 和 -x 混用；--noproxy '*' 会绕过代理。

App 侧验证#

请求发出后，在 Link1 App 中确认：

• 连接列表出现目标域名或目标 IP。

• 连接详情里能看到命中的规则。

• 出站显示为你预期的节点或策略组。

• 日志没有持续的 DNS、认证、握手或超时错误。

如果 curl 成功但 App 连接列表没有变化，通常说明请求没有经过 Link1，或你看的不是当前运行的配置档案。

局域网使用#

如果要让同一局域网内其他设备使用 Link1：

mixed-port: 7890
allow-lan: true
bind-address: '*'
lan-allowed-ips:
  - 192.168.0.0/16
authentication:
  - alice:password

实际影响：

• Link1 会监听所有网卡。

• 局域网设备可以把代理填成 Link1 主机 IP，例如 192.168.9.2:7890。

• lan-allowed-ips 限制哪些源 IP 可访问。

• authentication 要求客户端填写用户名密码。

风险：不要在公共 Wi-Fi 或不可信网络上无认证开放代理端口。

路由器使用#

路由器上常见做法：

• 显式代理：让设备手动填路由器 IP 和 mixed-port。

• 透明代理：使用 redir-port、tproxy-port 或 tun 接管设备流量。

• DNS 接管：让局域网设备的 DNS 指向路由器，再由 Link1 DNS 处理。

如果你用 TUN：

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

tun:
  enable: true
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

路由器场景的关键不是“内核是否启动”，而是三件事：

1. 局域网设备的流量是否被路由器接管。

1. 局域网设备的 DNS 是否进入 Link1。

1. Link1 的出站是否能从路由器本身访问外网。

常见启动问题#