Podman 部署 Clash 与 Yacd 局域网代理配置笔记

一、环境概述

宿主机：Linux（ARM架构）
容器运行时：Podman
代理核心：Clash（dreamacro/clash:dev）
管理面板：Yacd（Yet Another Clash Dashboard）
客户端：Windows 11 火狐浏览器

二、目录结构

/data/clash/
├── podman-compose.yml
└── config/
    └── config.yaml

三、Podman Compose 配置文件

文件路径：/data/clash/podman-compose.yml

services:
  clash:
    image: docker.io/dreamacro/clash:dev
    container_name: clash
    network_mode: bridge
    logging:
      driver: none
    ports:
      - "7895:7890"
      - "7896:7891"
      - "7897:9090"
    volumes:
      - ./config/config.yaml:/root/.config/clash/config.yaml:ro
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

  yacd:
    image: docker.io/haishanh/yacd:master
    container_name: yacd
    network_mode: bridge
    ports:
      - "1234:80"
    restart: unless-stopped

端口说明

宿主机端口	容器端口	用途
7895	7890	HTTP/SOCKS5 代理端口
7896	7891	混合代理端口
7897	9090	外部控制 API 端口（Yacd 连接用）

建议：为了便于记忆，可将 "7897:9090" 改为 "9090:9090"。

四、Clash 配置文件关键字段

文件路径：/data/clash/config/config.yaml

allow-lan: true
external-controller: 0.0.0.0:9090
secret: ""

字段说明

字段	正确值	错误值	说明
allow-lan	true	false	允许局域网设备连接代理
external-controller	0.0.0.0:9090	127.0.0.1:9090	API 监听地址，0.0.0.0 表示接受所有来源连接
secret	"" 或 "密码"	-	API 访问密码，空字符串表示无需认证

关键点：external-controller 必须设置为 0.0.0.0:9090，否则外部无法访问 API。

五、Yacd 面板配置

访问地址

http://宿主机IP:1234

三个字段的填写

Yacd 字段	填写内容	说明
API Base URL	`http://宿主机IP:7897`	宿主机 IP + Clash API 映射端口
Secret	留空	对应 config.yaml 中的 secret 字段
Label	任意名称	Yacd 本地标签，用于标识不同配置

填写示例

假设宿主机 IP 为 192.168.1.100：

字段	填写内容
API Base URL	`http://192.168.1.100:7897`
Secret	（留空）
Label	`办公Clash`

常见错误

错误填写	原因
`http://127.0.0.1:9090`	127.0.0.1 指向 Yacd 容器自身
`http://localhost:7897`	localhost 同样指向 Yacd 容器自身
`http://宿主机IP:9090`	端口错误，宿主机 9090 未映射

六、常用命令

查看端口映射

podman port clash

预期输出：

7890/tcp -> 0.0.0.0:7895
7891/tcp -> 0.0.0.0:7896
9090/tcp -> 0.0.0.0:7897

查看配置文件中的关键字段

grep -E "external-controller|secret|allow-lan" /data/clash/config/config.yaml

修改配置文件中 external-controller 的 IP

sed -i.bak 's/external-controller: 127.0.0.1:9090/external-controller: 0.0.0.0:9090/' /data/clash/config/config.yaml

启动所有服务

cd /data/clash
podman-compose up -d

单独启动或重启 Clash

podman-compose up -d clash
podman-compose restart clash

查看容器状态

podman-compose ps

查看日志

podman logs clash
podman-compose logs -f

测试 API 是否可访问

curl http://127.0.0.1:7897

正常响应应返回 404 page not found 或 JSON 格式内容。

七、故障排查

问题：curl 返回 Connection refused

可能原因：external-controller 设置为 127.0.0.1:9090

解决方案：

修改配置文件：
```
external-controller: 0.0.0.0:9090
```
重启容器：
```
podman-compose restart clash
```

问题：容器启动失败

排查步骤：

查看日志：
```
podman logs clash
```
确认配置文件格式正确（YAML 格式）
检查 config.yaml 是否完整

问题：Yacd 面板连接失败