Clash 中文文档

完整的技术文档与配置指南，帮助您充分利用 Clash 的强大功能

1

快速开始

欢迎使用 Clash！本指南将帮助您在 5 分钟内完成基础配置并开始使用。

1

下载客户端

访问下载页面，选择适合您操作系统的版本进行下载。

2

安装与启动

按照安装向导完成安装，首次启动时会自动创建配置文件。

3

配置订阅

在设置界面添加您的订阅链接，系统会自动同步节点信息。

2

基础配置

配置文件结构

Clash 使用 YAML 格式的配置文件，以下是基础配置示例：

YAML 
# Clash 基础配置文件
mixed-port: 7890
allow-lan: false
mode: "rule"
log-level: "info"

external-controller: "127.0.0.1:9090"

proxies:
  - name: "香港节点"
    type: "vmess"
    server: "hk.example.com"
    port: 443
    uuid: "your-uuid-here"
    alterId: 0
    cipher: "auto"
    tls: true
    servername: "hk.example.com"
    network: "ws"

proxy-groups:
  - name: "自动选择"
    type: "url-test"
    proxies:
      - "香港节点"
    url: "http://www.gstatic.com/generate_204"
    interval: 300

rules:
  - DOMAIN-SUFFIX,google.com,自动选择
  - IP-CIDR,1.0.0.0/8,DIRECT
  - MATCH,自动选择

注意：配置文件的缩进非常重要，请确保使用空格而非 Tab 键进行缩进。

3

API 参考

REST API 接口

Clash 提供了完整的 REST API 用于程序化控制：

JavaScript 
// 获取当前连接状态
const response = await fetch('http://127.0.0.1:9090/connections');
const connections = await response.json();

// 切换代理模式
await fetch('http://127.0.0.1:9090/configs', {
    method: 'PATCH',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        mode: 'rule'
    })
});

// 获取配置文件
const configResponse = await fetch('http://127.0.0.1:9090/configs');
const config = await configResponse.json();

可用 API 端点

4

常见问题

连接问题

问题：客户端无法连接

解决方案：

  1. 检查防火墙设置，确保 7890 端口未被阻止
  2. 验证配置文件语法是否正确
  3. 检查订阅链接是否有效

性能优化

如果遇到速度较慢的问题，可以尝试以下优化：

  1. 调整延迟测试间隔为 600 秒
  2. 启用 UDP 转发
  3. 使用负载均衡模式替代自动选择