Skip to content

REFERENCE_CARD.md

Latest commit

 

History

History
187 lines (139 loc) · 4.04 KB

REFERENCE_CARD.md

File metadata and controls

187 lines (139 loc) · 4.04 KB

🚀 快速参考卡片

一键部署命令

# 1. 下载项目
git clone https://github.com/DeyiXu/go-docker-proxy.git
cd go-docker-proxy

# 2. 一键部署
sudo ./deploy-overseas.sh

# 3. 监控服务
./monitor.sh -m

核心文档(按阅读顺序)

顺序 文档 用途 阅读时间
1️⃣ README.md 项目概述 5分钟
2️⃣ QUICKSTART.md 快速部署 10分钟
3️⃣ DEPLOYMENT_CN.md 详细指南 30分钟
4️⃣ NETWORK_OPTIMIZATION.md 性能优化 45分钟
5️⃣ ARCHITECTURE.md 技术架构 20分钟

常用命令

部署相关

# 启动服务
docker compose up -d

# 停止服务
docker compose down

# 重启服务
docker compose restart

# 查看日志
docker compose logs -f

# 更新服务
docker compose pull && docker compose up -d

监控相关

# 实时监控
./monitor.sh -m

# 单次检查
./monitor.sh -c

# 性能测试
./monitor.sh -p

# 查看日志
./monitor.sh -l 100

# 清理缓存
./monitor.sh -C

维护相关

# 查看缓存大小
du -sh cache/

# 查看容器状态
docker ps

# 查看资源使用
docker stats go-docker-proxy

# 备份配置
tar czf backup-$(date +%Y%m%d).tar.gz docker-compose.yml cache/

推荐部署地区

地区 延迟 速度 成本/月 推荐度
🇭🇰 亚太A区 20-50ms 10-50MB/s $30-50 ⭐⭐⭐⭐⭐
🇸🇬 新加坡 60-100ms 5-30MB/s $20-40 ⭐⭐⭐⭐
🇯🇵 东京 80-120ms 5-20MB/s $20-40 ⭐⭐⭐⭐

性能数据

指标 优化后
TCP延迟 30ms
下载速度(首次) 20MB/s
下载速度(缓存) 80MB/s
并发能力 100+ req/s
缓存命中率 85%

DNS配置示例

# A记录
docker.yourdomain.com    A    <服务器IP>
quay.yourdomain.com      A    <服务器IP>
gcr.yourdomain.com       A    <服务器IP>
ghcr.yourdomain.com      A    <服务器IP>

# 或使用通配符
*.yourdomain.com         A    <服务器IP>

Nginx + SSL 快速配置

# 安装 Nginx 和 Certbot
sudo apt install nginx certbot python3-certbot-nginx

# 申请 SSL 证书
sudo certbot --nginx -d docker.yourdomain.com

# 自动续期
sudo certbot renew --dry-run

客户端配置

# 方法1: 配置 daemon.json
sudo tee /etc/docker/daemon.json << EOF
{
  "registry-mirrors": [
    "https://docker.yourdomain.com"
  ]
}
EOF

sudo systemctl restart docker

# 方法2: 直接使用完整地址
docker pull docker.yourdomain.com/library/nginx:latest

故障排查

问题 解决方法
服务无法启动 docker logs go-docker-proxy
端口未监听 sudo netstat -tuln | grep 8080
防火墙问题 sudo ufw allow 80,443/tcp
SSL证书问题 sudo certbot certificates
速度慢 查看 NETWORK_OPTIMIZATION.md

环境变量

PORT=8080                    # 服务端口
CACHE_DIR=/cache             # 缓存目录
DEBUG=false                  # 调试模式
CUSTOM_DOMAIN=yourdomain.com # 自定义域名

项目统计

  • 📝 文档: 9个 (75KB+)
  • 🛠️ 脚本: 3个 (自动化部署+监控+测试)
  • 💻 代码: 2个 (main.go + cache.go)
  • 📦 配置: 4个 (Docker + Go)
  • ⭐ 特性: 100%兼容 ciiiii/cloudflare-docker-proxy

支持的仓库

  • ✅ Docker Hub (docker.yourdomain.com)
  • ✅ Quay.io (quay.yourdomain.com)
  • ✅ Google GCR (gcr.yourdomain.com)
  • ✅ Kubernetes (k8s.yourdomain.com)
  • ✅ GitHub CR (ghcr.yourdomain.com)
  • ✅ AWS ECR (ecr.yourdomain.com)
  • ✅ Cloudsmith (cloudsmith.yourdomain.com)

获取帮助

快速开始: sudo ./deploy-overseas.sh 🚀