ClashLink - VLESS/VMess 到 Clash 订阅转换工具

# 一条命令启动 ClashLink
mkdir clashlink && cd clashlink
curl -O https://raw.githubusercontent.com/uttogg/ClashLink/main/docker-compose.yml
docker-compose up -d

# 访问应用
echo "🎉 ClashLink 已启动: http://localhost:8080"

# 启动服务
docker-compose up -d

# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

# 创建数据目录
mkdir -p data/{database,subscriptions,logs}

# 拉取最新镜像
docker pull uttogg/clashlink:latest

# 运行容器
docker run -d \
  --name clashlink-app \
  --restart unless-stopped \
  -p 8080:8080 \
  -v $(pwd)/data/database:/app/backend \
  -v $(pwd)/data/subscriptions:/app/subscriptions \
  -v $(pwd)/data/logs:/app/logs \
  -e TZ=Asia/Shanghai \
  -e JWT_SECRET=your-secure-jwt-secret \
  uttogg/clashlink:latest

# 查看容器状态
./docker-run.sh status

# 查看实时日志
./docker-run.sh logs -f

# 进入容器 shell
./docker-run.sh shell

# 备份数据
./docker-run.sh backup

# 更新容器
./docker-run.sh update

# 重启容器
./docker-run.sh restart

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基本工具
# Ubuntu/Debian:
sudo apt install -y curl wget git unzip tar

# CentOS/RHEL 8+:
# sudo dnf install -y curl wget git unzip tar

# 旧版本 CentOS/RHEL:
# sudo yum install -y curl wget git unzip tar

# 下载 Go 1.21.5 (请检查最新版本)
cd /tmp
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz

# 删除旧版本并安装新版本
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

# 设置环境变量
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export GOBIN=$GOPATH/bin' >> ~/.bashrc

# 重新加载环境变量
source ~/.bashrc

# 验证安装
go version

# 创建应用目录
sudo mkdir -p /opt/clashlink
sudo chown $USER:$USER /opt/clashlink
cd /opt/clashlink

# 克隆或上传项目文件
# 方法1: 如果使用Git
git clone <your-repo-url> .

# 方法2: 手动上传文件
# 将项目文件上传到 /opt/clashlink 目录

# 设置正确的权限
sudo chown -R $USER:$USER /opt/clashlink
chmod +x backend/*.go

# 进入后端目录
cd /opt/clashlink/backend

# 下载 Go 依赖
go mod tidy

# 创建必要的目录
mkdir -p /opt/clashlink/subscriptions

# 设置目录权限
chmod 755 /opt/clashlink/subscriptions

# 编译应用
cd /opt/clashlink/backend
go build -o clashlink .

# 验证编译结果
./clashlink --help 2>/dev/null || echo "编译成功，准备启动"

# 创建系统用户
sudo useradd --system --no-create-home --shell /bin/false clashlink

# 设置文件权限
sudo chown -R clashlink:clashlink /opt/clashlink
sudo chmod +x /opt/clashlink/backend/clashlink

# 创建 systemd 服务文件
sudo tee /etc/systemd/system/clashlink.service > /dev/null <<EOF
[Unit]
Description=ClashLink - VLESS/VMess to Clash Converter
After=network.target
Wants=network.target

[Service]
Type=simple
User=clashlink
Group=clashlink
WorkingDirectory=/opt/clashlink/backend
ExecStart=/opt/clashlink/backend/clashlink
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal

# 安全设置
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/opt/clashlink

# 环境变量
Environment=GIN_MODE=release

[Install]
WantedBy=multi-user.target
EOF

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start clashlink

# 设置开机自启
sudo systemctl enable clashlink

# 检查服务状态
sudo systemctl status clashlink

# 查看服务日志
sudo journalctl -u clashlink -f

# 如果使用 UFW 防火墙
sudo ufw allow 8080/tcp
sudo ufw reload

# 如果使用 iptables
sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
sudo iptables-save > /etc/iptables/rules.v4

# 安装 Nginx
sudo apt install -y nginx

# 创建站点配置
sudo tee /etc/nginx/sites-available/clashlink > /dev/null <<EOF
server {
    listen 80;
    server_name your-domain.com;  # 替换为你的域名
    
    # 安全头
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    
    # 限制请求大小
    client_max_body_size 1M;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host \$host;
        proxy_set_header X-Real-IP \$remote_addr;
        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto \$scheme;
        proxy_cache_bypass \$http_upgrade;
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
    
    # 静态文件缓存
    location /static/ {
        proxy_pass http://127.0.0.1:8080;
        expires 7d;
        add_header Cache-Control "public, immutable";
    }
    
    # 订阅文件
    location /subscriptions/ {
        proxy_pass http://127.0.0.1:8080;
        expires 1h;
    }
}
EOF

# 启用站点
sudo ln -s /etc/nginx/sites-available/clashlink /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
sudo systemctl enable nginx

# 安装 Certbot
sudo apt install -y certbot python3-certbot-nginx

# 获取 SSL 证书
sudo certbot --nginx -d your-domain.com

# 设置自动续期
sudo crontab -e
# 添加以下行：
# 0 12 * * * /usr/bin/certbot renew --quiet

# 查看服务状态
sudo systemctl status clashlink

# 查看实时日志
sudo journalctl -u clashlink -f

# 重启服务
sudo systemctl restart clashlink

# 查看端口占用
sudo netstat -tlnp | grep :8080

# 检查磁盘使用
du -sh /opt/clashlink/subscriptions/

# 清理旧的订阅文件（建议定期执行）
find /opt/clashlink/subscriptions/ -name "*.yaml" -mtime +7 -delete

# 检查日志
sudo journalctl -u clashlink --no-pager

# 检查端口占用
sudo lsof -i :8080

# 手动测试
cd /opt/clashlink/backend
sudo -u clashlink ./clashlink

# 重新设置权限
sudo chown -R clashlink:clashlink /opt/clashlink
sudo chmod +x /opt/clashlink/backend/clashlink

# 检查数据库文件
ls -la /opt/clashlink/backend/data.db
sudo -u clashlink touch /opt/clashlink/backend/data.db

# 查看当前运行的版本信息
cd /opt/clashlink/backend
./clashlink --version 2>/dev/null || echo "当前版本未知"

# 查看服务状态
sudo systemctl status clashlink

# 备份当前配置
sudo cp -r /opt/clashlink /opt/clashlink.backup.$(date +%Y%m%d_%H%M%S)

# 备份数据库
sudo cp /opt/clashlink/backend/data.db /opt/clashlink/backend/data.db.backup.$(date +%Y%m%d_%H%M%S)

# 备份重要配置文件
sudo tar -czf /opt/clashlink_backup_$(date +%Y%m%d_%H%M%S).tar.gz \
    /opt/clashlink/backend/data.db \
    /etc/systemd/system/clashlink.service \
    /etc/nginx/sites-available/clashlink

# 验证备份
ls -la /opt/clashlink_backup_*.tar.gz

# 停止服务
sudo systemctl stop clashlink

# 进入项目目录
cd /opt/clashlink

# 拉取最新代码
git fetch origin
git pull origin main

# 查看更新日志
git log --oneline -10

# 更新依赖
cd backend
go mod tidy

# 重新编译
go build -o clashlink .

# 设置权限
sudo chown clashlink:clashlink clashlink
sudo chmod +x clashlink

# 重启服务
sudo systemctl start clashlink
sudo systemctl status clashlink

# 停止服务
sudo systemctl stop clashlink

# 下载新版本文件到临时目录
cd /tmp
wget https://github.com/your-repo/releases/download/v1.x.x/clashlink-linux.tar.gz
tar -xzf clashlink-linux.tar.gz

# 备份当前版本
sudo mv /opt/clashlink/backend/clashlink /opt/clashlink/backend/clashlink.old

# 替换可执行文件
sudo cp clashlink-linux/backend/clashlink /opt/clashlink/backend/
sudo chown clashlink:clashlink /opt/clashlink/backend/clashlink
sudo chmod +x /opt/clashlink/backend/clashlink

# 更新前端文件（如果有变化）
sudo cp -r clashlink-linux/frontend/* /opt/clashlink/frontend/
sudo chown -R clashlink:clashlink /opt/clashlink/frontend/

# 重启服务
sudo systemctl start clashlink

# 拉取最新镜像
docker pull your-registry/clashlink:latest

# 停止并删除旧容器
docker stop clashlink
docker rm clashlink

# 启动新容器
docker run -d --name clashlink \
    -p 8080:8080 \
    -v /opt/clashlink/data:/app/data \
    -v /opt/clashlink/subscriptions:/app/subscriptions \
    --restart unless-stopped \
    your-registry/clashlink:latest

# 检查服务状态
sudo systemctl status clashlink

# 测试端口连通性
curl -I http://localhost:8080

# 查看服务日志
sudo journalctl -u clashlink -n 20

# 测试数据库连接
sudo -u clashlink /opt/clashlink/backend/clashlink --test-db 2>/dev/null || echo "需要手动测试数据库"

# 测试登录页面
curl -s http://localhost:8080/ | grep -q "ClashLink" && echo "✅ 首页正常" || echo "❌ 首页异常"

# 测试 API 端点
curl -s http://localhost:8080/api/init | grep -q "message" && echo "✅ API 正常" || echo "❌ API 异常"

# 测试静态文件
curl -I http://localhost:8080/static/style.css | grep -q "200 OK" && echo "✅ 静态文件正常" || echo "❌ 静态文件异常"

# 停止服务
sudo systemctl stop clashlink

# 恢复可执行文件
sudo mv /opt/clashlink/backend/clashlink.old /opt/clashlink/backend/clashlink

# 恢复数据库（如果需要）
sudo cp /opt/clashlink/backend/data.db.backup.* /opt/clashlink/backend/data.db

# 重启服务
sudo systemctl start clashlink

# 验证回滚
sudo systemctl status clashlink

# 停止服务
sudo systemctl stop clashlink

# 删除当前版本
sudo rm -rf /opt/clashlink

# 恢复备份
sudo tar -xzf /opt/clashlink_backup_*.tar.gz -C /

# 或者从备份目录恢复
sudo mv /opt/clashlink.backup.* /opt/clashlink

# 重启服务
sudo systemctl start clashlink

# 创建升级脚本
sudo tee /opt/clashlink/upgrade.sh > /dev/null <<'EOF'
#!/bin/bash

# ClashLink 升级脚本
set -e

BACKUP_DIR="/opt/clashlink_backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
LOG_FILE="/var/log/clashlink_upgrade.log"

# 创建日志函数
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}

# 创建备份目录
mkdir -p "$BACKUP_DIR"

log "开始升级 ClashLink..."

# 备份当前版本
log "备份当前版本..."
sudo systemctl stop clashlink
cp -r /opt/clashlink "$BACKUP_DIR/clashlink_$TIMESTAMP"
cp /opt/clashlink/backend/data.db "$BACKUP_DIR/data_$TIMESTAMP.db"

# 拉取更新
log "拉取最新代码..."
cd /opt/clashlink
git pull origin main

# 更新依赖和编译
log "编译新版本..."
cd backend
go mod tidy
go build -o clashlink .

# 设置权限
sudo chown clashlink:clashlink clashlink
sudo chmod +x clashlink

# 启动服务
log "启动服务..."
sudo systemctl start clashlink

# 验证升级
sleep 5
if sudo systemctl is-active --quiet clashlink; then
    log "✅ 升级成功！服务正常运行"
    
    # 清理旧备份（保留最近3个）
    cd "$BACKUP_DIR"
    ls -t clashlink_* | tail -n +4 | xargs -r rm -rf
    ls -t data_*.db | tail -n +4 | xargs -r rm -f
    
else
    log "❌ 升级失败，开始回滚..."
    sudo systemctl stop clashlink
    cp -r "$BACKUP_DIR/clashlink_$TIMESTAMP"/* /opt/clashlink/
    sudo systemctl start clashlink
    log "回滚完成"
    exit 1
fi

log "升级完成！"
EOF

# 设置执行权限
sudo chmod +x /opt/clashlink/upgrade.sh

# 创建升级检查脚本
sudo tee /opt/clashlink/check_updates.sh > /dev/null <<'EOF'
#!/bin/bash

# 检查是否有新版本
cd /opt/clashlink

# 获取远程最新提交
git fetch origin

# 比较本地和远程版本
LOCAL=$(git rev-parse HEAD)
REMOTE=$(git rev-parse origin/main)

if [ "$LOCAL" != "$REMOTE" ]; then
    echo "发现新版本！"
    echo "本地版本: $LOCAL"
    echo "远程版本: $REMOTE"
    
    # 可以选择自动升级或发送通知
    # /opt/clashlink/upgrade.sh
    
    # 或者发送邮件通知
    # echo "ClashLink 有新版本可用" | mail -s "ClashLink Update Available" admin@example.com
else
    echo "当前已是最新版本"
fi
EOF

sudo chmod +x /opt/clashlink/check_updates.sh

# 添加到定时任务（每天检查一次）
(crontab -l 2>/dev/null; echo "0 2 * * * /opt/clashlink/check_updates.sh") | crontab -

# 如果新版本需要数据库结构更新
sudo tee /opt/clashlink/migrate_db.sh > /dev/null <<'EOF'
#!/bin/bash

# 数据库迁移脚本
DB_FILE="/opt/clashlink/backend/data.db"
BACKUP_FILE="/opt/clashlink/backend/data.db.pre_migration.$(date +%Y%m%d_%H%M%S)"

# 备份数据库
cp "$DB_FILE" "$BACKUP_FILE"

# 执行迁移 SQL
sqlite3 "$DB_FILE" <<SQL
-- 示例：添加新字段
-- ALTER TABLE users ADD COLUMN last_login DATETIME;
-- 
-- 示例：创建新表
-- CREATE TABLE IF NOT EXISTS user_sessions (
--     id INTEGER PRIMARY KEY AUTOINCREMENT,
--     user_id INTEGER,
--     session_token TEXT,
--     created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-- );

-- 更新版本信息
INSERT OR REPLACE INTO system_settings (setting_key, setting_value) 
VALUES ('db_version', '1.1.0');
SQL

echo "数据库迁移完成"
EOF

sudo chmod +x /opt/clashlink/migrate_db.sh

# 创建升级日志模板
sudo tee /opt/clashlink/UPGRADE_LOG.md > /dev/null <<'EOF'
# ClashLink 升级日志

## 升级记录

### v1.1.0 -> v1.2.0 (2024-01-15)
- **升级时间**: 2024-01-15 02:00 AM
- **升级人员**: admin
- **升级内容**: 
  - 新增用户管理功能
  - 优化节点检测算法
  - 修复已知安全问题
- **数据库变更**: 添加 user_sessions 表
- **配置变更**: 无
- **回滚**: 无需回滚
- **问题**: 无

### 升级检查清单
- [ ] 备份数据库
- [ ] 备份配置文件
- [ ] 停止服务
- [ ] 更新代码
- [ ] 运行数据库迁移
- [ ] 重新编译
- [ ] 启动服务
- [ ] 验证功能
- [ ] 监控日志
EOF

# 运行开发服务器
cd backend
go run .

# 构建生产版本
go build -o clashlink