kouleen/shadowsocks2 repository overview

⁠🚀 kouleen/shadowsocks2 - 环境变量一键切换·服务端/客户端通用镜像

⁠镜像简介

kouleen/shadowsocks2 是基于 Go 语言 + Alpine Linux 构建的超轻量、高性能、现代化 Shadowsocks 代理镜像。 一份镜像 = 服务端 + 客户端，通过环境变量一键切换，支持 TCP/UDP、DNS 隧道、Socks5 本地代理，适合 VPS、NAS、软路由、内网穿透使用。

⁠核心特性

✅ 服务端 / 客户端 二合一 → 只需一个镜像，MODE 切换

✅ Go 原生高性能 → 速度快、资源占用极低

✅ 环境变量全自动配置 → 无需手写配置文件

✅ AEAD 强加密 → 安全、现代、防劫持

✅ UDP + TCP 双隧道 → 支持游戏、DNS、流媒体

✅ 内置国内 GOPROXY → 构建速度拉满

✅ 超小体积 → 仅 15MB 左右

✅ 长期维护 → 自动跟随上游更新

⁠默认端口

• 8488 → 服务端端口
• 1080 → 客户端 Socks5 本地代理端口
• 8053 / 8054 → 默认 DNS 隧道端口

⁠🧩 完整环境变量说明（必看）

⁠🚀 快速启动：服务端模式

docker run -d \
  --name ss2-server \
  --restart always \
  -p 8488:8488/tcp \
  -p 8488:8488/udp \
  -e MODE=server \
  -e PASSWORD=your-password \
  kouleen/shadowsocks2:tagname

⁠🚀 快速启动：客户端模式

docker run -d \
  --name ss2-client \
  --restart always \
  --network host \
  -e MODE=client \
  -e SERVER_ADDR=1.2.3.4 \
  -e SERVER_PORT=8488 \
  -e PASSWORD=your-password \
  kouleen/shadowsocks2:tagname

⁠⚙️ 完整自定义启动示例

docker run -d \
  --name ss2 \
  --restart always \
  --network host \
  -e MODE=client \
  -e CIPHER=AEAD_CHACHA20_POLY1305 \
  -e SERVER_ADDR=1.2.3.4 \
  -e SERVER_PORT=8488 \
  -e PASSWORD=123456789 \
  -e SOCKS_PORT=1080 \
  -e TUNNEL_CONF=":8053=8.8.8.8:53,:8054=8.8.4.4:53" \
  kouleen/shadowsocks2:tagname

⁠常用管理命令

# 查看实时日志
docker logs -f ss2

# 重启
docker restart ss2

# 停止/删除
docker stop ss2
docker rm -f ss2

# 更新镜像
docker pull kouleen/shadowsocks2:latest

⁠适用场景

• VPS 搭建 Shadowsocks 代理服务
• 本地客户端科学上网
• 内网 DNS 隧道、UDP 穿透
• 游戏加速、语音传输
• NAS / 软路由 / Docker 环境 7×24 小时运行

⁠常见问题

⁠Q1：服务端与客户端必须配置什么？

必须一致：PASSWORD + CIPHER

⁠Q2：客户端如何使用？

本地 Socks5 代理：127.0.0.1:1080

⁠Q3：隧道 TUNNEL_CONF 有什么用？

用于端口映射、DNS 穿透、内网端口转发。

⁠Q4：支持哪些加密？

• AEAD_CHACHA20_POLY1305（推荐）
• AEAD_AES_256_GCM

⁠作者信息

🐳 Docker Hub: kouleen/shadowsocks2⁠ 📧 邮箱: [email protected]⁠

⁠💡 超轻量、超稳定、一键部署！好用欢迎点 ⭐ Star！