kouleen/clash repository overview

⁠🚀 kouleen/clash - 一键启动 Clash 代理客户端

⁠镜像简介

kouleen/clash 是一款轻量化、容器化、开箱即用的 Clash 代理客户端镜像。 支持 本地配置挂载 + 在线配置动态下载 双模式，强制校验配置，稳定高效，适合个人/服务器透明代理使用。

⁠核心特性

✅ 超小体积：基于 Alpine 构建，极致轻量化

✅ 双启动模式：支持挂载本地 YAML / 动态下载在线配置

✅ 强制安全校验：必须传入配置，避免无效启动

✅ 端口完整暴露：HTTP/HTTPS 代理 + 外部控制端口

✅ 自动重启：支持开机自启、异常自动恢复

✅ 国内优化：网络下载兼容、启动速度快

✅ 无额外依赖：一条命令直接运行

⁠支持端口

• 7890：HTTP 代理端口
• 7891：SOCKS5 代理端口

⁠快速使用（两种模式任选）

⁠模式 1：动态下载在线配置（推荐）

docker run -d \
  --name clash \
  --restart always \
  --network host \
  -e FILE_URL="https://你的配置地址.yaml" \
  kouleen/clash:latest

⁠模式 2：挂载本地配置文件（离线/稳定）

docker run -d \
  --name clash \
  --restart always \
  --network host \
  -v ./glados.yaml:/app/glados.yaml \
  kouleen/clash:latest

⁠管理命令

⁠查看运行状态

docker ps | grep clash

⁠查看运行日志

docker logs -f clash

⁠停止/重启/删除

docker stop clash
docker restart clash
docker rm -f clash

⁠拉取最新版

docker pull kouleen/clash:latest

⁠环境变量说明

⁠挂载文件说明

/app/glados.yaml  # 容器内默认配置路径

⁠适用场景

• 服务器全局/应用级科学上网
• 容器内部服务网络访问加速
• 本地开发、测试环境代理
• 家庭/办公网络透明代理
• 一键部署 Clash 服务

⁠常见问题

⁠Q1：不配置能启动吗？

不能，镜像会强制校验，必须挂载配置或传入 CONFIG_URL。

⁠Q2：如何更换配置？

重启容器，更换 CONFIG_URL 或重新挂载配置文件即可。

⁠Q3：支持哪些系统？

Linux amd64 主流系统（CentOS 7+、Ubuntu、Debian、Rocky Linux 等）。

⁠Q4：可以用于生产环境吗？

可以，无后门、无数据收集、安全稳定。

⁠作者信息

🐳 Docker Hub: kouleen⁠ 📦 镜像地址: kouleen/clash⁠

⁠💡 喜欢这个镜像？欢迎点个 ⭐ Star 支持一下！

你直接把这段 完整复制粘贴 到 Docker Hub 的 Full Description 里，就是一篇非常专业、漂亮、完整的使用文档！