订阅转换完全指南：subconverter、ACL 规则与订阅管理全流程

# 拉取最新镜像
docker pull tindy2013/subconverter:latest

# 启动容器
docker run -d \
  --name=subconverter \
  --restart=always \
  -p 25500:25500 \
  tindy2013/subconverter:latest

# 测试是否正常
curl http://127.0.0.1:25500/sub?target=clash
# 应返回一个 JSON 格式的 Clash 配置骨架

# 下载最新版本（Linux amd64）
VERSION=$(curl -s https://api.github.com/repos/tindy2013/subconverter/releases/latest | grep tag_name | cut -d '"' -f 4)
curl -fsSL https://github.com/tindy2013/subconverter/releases/download/$VERSION/subconverter_linux64.tar.gz

# 解压
tar -xzvf subconverter_linux64.tar.gz
cd subconverter/

# 启动
./subconverter --backend &

# 后台运行（使用 systemd）
cat > /etc/systemd/system/subconverter.service << 'EOF'
[Unit]
Description=subconverter service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/subconverter
ExecStart=/opt/subconverter/subconverter
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl enable --now subconverter

# 部署 sub-web（提供前端 UI）
docker run -d \
  --name=sub-web \
  --restart=always \
  -p 80:80 \
  -e API_URL=http://127.0.0.1:25500 \
  careywong/subweb:latest

# 访问 http://your-server-ip 即可使用图形界面

# 示例 1: 转换单个订阅为 Clash 格式，添加国旗
curl "http://127.0.0.1:25500/sub?target=clash&url=aHR0cHM6Ly9leGFtcGxlLmNvbS9zdWJzY3JpcHRpb24&emoji=true&list=true" -o config.yaml

# 示例 2: 合并多个订阅为 Clash.Meta 格式
# 假设 sub1_url 和 sub2_url 是两个订阅链接
SUB1=$(echo -n "https://example1.com/subscription" | base64 -w0)
SUB2=$(echo -n "https://example2.com/subscription" | base64 -w0)

curl "http://127.0.0.1:25500/sub?target=clashmeta&url=${SUB1}|${SUB2}&config=ACL4SSR_Online_NoAuto.ini&emoji=true" \
  -o merged_config.yaml

# 示例 3: 指定 ACL 规则模板
curl "http://127.0.0.1:25500/sub?target=clash&url=${SUB_URL}&config=https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online.ini&emoji=true" \
  -o custom_config.yaml

# 示例 4: 启用 TFO + UDP（高性能）
curl "http://127.0.0.1:25500/sub?target=clash&url=${SUB_URL}&tfo=true&udp=true&sort=true" \
  -o performance_config.yaml

# 方式一: 使用内置模板（subconverter 自带）
# 文件名: ACL4SSR_Online.ini、ACL4SSR_Online_Full.ini 等

# 方式二: 使用远程模板（实时更新）
# GitHub 上的高质量 ACL 模板：
# https://github.com/ACL4SSR/ACL4SSR/tree/master/Clash/config
# https://github.com/Loyalsoldier/clash-rules/tree/master
# https://github.com/GeQ1an/Rules/blob/master/Clash/ACL4SSR.ini

# 使用远程模板
curl "http://127.0.0.1:25500/sub?target=clash&url=${SUB_URL}&config=https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_NoAuto.ini"

; 完整 ACL 模板示例（ACL4SSR_Online.ini）
; 说明：以分号开头的行为注释

; ─────────────────────────────────────────
; 1. [custom] 节点自定义配置
; ─────────────────────────────────────────

[custom]
; 是否添加 Emoji 标志（已通过 emoji 参数控制）
; 设置自定义参数，会覆盖全局设置

; ─────────────────────────────────────────
; 2. [common] 通用配置
; ─────────────────────────────────────────

[common]
; 端口配置
port=7890
socks-port=7891
allow-lan=true
mode=rule
log-level=warning
external-controller=127.0.0.1:9090

; DNS 配置
dns-server=223.5.5.5, 119.29.29.29, 8.8.8.8, https://1.1.1.1/dns-query

; 其他配置
tcp-fast-open=true
udp=true

; ─────────────────────────────────────────
; 3. [proxy_group] 策略组配置
; ─────────────────────────────────────────

; 格式: 组名, 组类型, 节点选择规则

[proxy_group]
; 主策略组：手动选择
🚀 节点选择,select,[]
⚡ 自动选择,url-test,[]
♻️ 故障转移,fallback,[]

; 按地区策略组
🇭🇰 香港节点,select,[]
🇯🇵 日本节点,select,[]
🇺🇸 美国节点,select,[]
🇸🇬 新加坡节点,select,[]
🇹🇼 台湾节点,select,[]

; 特殊策略
🎯 全球直连,select,[]
🐟 漏网之鱼,select,[]
🛑 广告拦截,select,[]

; ─────────────────────────────────────────
; 4. [rule] 规则配置
; ─────────────────────────────────────────

; 格式: 规则文件 URL, 策略组名, 规则类型, 是否优先

[rule]
; 广告与追踪拦截
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/reject.txt,🛑 广告拦截
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/gfw.txt,🚀 节点选择

; 国内直连
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/cn.txt,🎯 全球直连
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/direct.txt,🎯 全球直连

; 代理规则
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/proxy.txt,🚀 节点选择
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/telegram.txt,🚀 节点选择
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/apple.txt,🚀 节点选择

; 流媒体规则
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/netflix.txt,🎬 流媒体
https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/spotify.txt,🎬 流媒体

; 默认规则（匹配所有未被上面规则命中的请求）
[]FINAL,🐟 漏网之鱼

# emoji=true          # 添加国旗
# list=true           # 使用完整规则列表（支持更多节点类型）
# sort=true           # 按节点名称排序

# 通过参数或 ACL 过滤特定类型节点
# 1. 只保留特定协议节点（在 ACL 中配置）

# 2. 自定义过滤规则（在 ACL 的 [custom] 部分配置）
# 例如只保留香港、日本、美国节点
include=香港|日本|美国|新加坡|台湾
exclude=测试|过期|流量

# 3. 去重
# subconverter 自动根据服务器 IP + 端口去重

# 1. 部署 subconverter 后端
docker run -d \
  --name=subconverter \
  --restart=always \
  -p 25500:25500 \
  -v /opt/subconverter:/base \
  tindy2013/subconverter:latest

# 2. 部署 sub-web 前端
docker run -d \
  --name=sub-web \
  --restart=always \
  -p 80:80 \
  -e API_URL=http://127.0.0.1:25500 \
  careywong/subweb:latest

# 3. 添加 Nginx 反向代理（可选，便于 HTTPS）
# /etc/nginx/conf.d/subconverter.conf
server {
    listen 443 ssl http2;
    server_name sub.example.com;

    ssl_certificate /etc/letsencrypt/live/sub.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sub.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:25500;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

# 4. 测试
curl "https://sub.example.com/sub?target=clash&url=${SUB_URL}&config=ACL4SSR_Online.ini&emoji=true"

#!/bin/bash
# /opt/scripts/update_subscription.sh
# 定期更新订阅的脚本

# 配置变量
SUB_URL="https://your-airport.com/subscription/link"
SUB_BASE64=$(echo -n "$SUB_URL" | base64 -w0)
OUTPUT_DIR="/opt/subscriptions"
SUB_HOST="http://127.0.0.1:25500"

# 创建输出目录
mkdir -p "$OUTPUT_DIR"

# 生成不同目标格式
echo "[1/5] 生成 Clash 配置..."
curl -s "${SUB_HOST}/sub?target=clash&url=${SUB_BASE64}&config=ACL4SSR_Online.ini&emoji=true&list=true&tfo=true&udp=true" \
  -o "$OUTPUT_DIR/clash_config.yaml"

echo "[2/5] 生成 Clash.Meta 配置..."
curl -s "${SUB_HOST}/sub?target=clashmeta&url=${SUB_BASE64}&config=ACL4SSR_Online.ini&emoji=true&list=true&tfo=true&udp=true" \
  -o "$OUTPUT_DIR/clashmeta_config.yaml"

echo "[3/5] 生成 Mihomo 配置..."
curl -s "${SUB_HOST}/sub?target=mihomo&url=${SUB_BASE64}&config=ACL4SSR_Online.ini&emoji=true&list=true&tfo=true&udp=true" \
  -o "$OUTPUT_DIR/mihomo_config.yaml"

echo "[4/5] 生成 sing-box 配置..."
curl -s "${SUB_HOST}/sub?target=singbox&url=${SUB_BASE64}&config=ACL4SSR_Online.ini&emoji=true" \
  -o "$OUTPUT_DIR/singbox_config.json"

echo "[5/5] 生成 Shadowrocket 配置..."
curl -s "${SUB_HOST}/sub?target=shadowrocket&url=${SUB_BASE64}&emoji=true" \
  -o "$OUTPUT_DIR/shadowrocket_config.yaml"

# 输出统计
echo ""
echo "✅ 订阅更新完成: $(date +'%Y-%m-%d %H:%M:%S')"
ls -lh "$OUTPUT_DIR"/*.yaml "$OUTPUT_DIR"/*.json

# 添加到 crontab，每 6 小时更新一次
crontab -e
# 0 */6 * * * /opt/scripts/update_subscription.sh >> /var/log/subscription.log 2>&1

# 或者使用 systemd timer
cat > /etc/systemd/system/subscription.service << 'EOF'
[Unit]
Description=Update subscription configs
After=network.target

[Service]
Type=oneshot
ExecStart=/bin/bash /opt/scripts/update_subscription.sh

[Install]
WantedBy=multi-user.target
EOF

cat > /etc/systemd/system/subscription.timer << 'EOF'
[Unit]
Description=Update subscription every 6 hours

[Timer]
OnBootSec=5min
OnUnitActiveSec=6h
Unit=subscription.service

[Install]
WantedBy=timers.target
EOF

systemctl enable --now subscription.timer

# 方式一：通过 subconverter 直接合并
# 使用 | 分隔多个订阅链接

SUB1=$(echo -n "https://airport1.com/sub" | base64 -w0)
SUB2=$(echo -n "https://airport2.com/sub" | base64 -w0)
SUB3=$(echo -n "https://airport3.com/sub" | base64 -w0)

# 合并三个订阅为一个 Clash 配置
curl "http://127.0.0.1:25500/sub?target=clash&url=${SUB1}|${SUB2}|${SUB3}&config=ACL4SSR_Online.ini&emoji=true&sort=true" \
  -o merged_subscription.yaml

# 方式二：通过 shell 脚本合并（更灵活）
#!/bin/bash
# 合并多个订阅并保留各机场标记

MERGED=""

for i in 1 2 3; do
    SUB_URL="https://airport${i}.com/sub"
    SUB_B64=$(echo -n "$SUB_URL" | base64 -w0)

    # 为每个机场的节点添加机场前缀
    curl -s "http://127.0.0.1:25500/sub?target=clash&url=${SUB_B64}&emoji=true" \
      -o /tmp/airport_${i}.yaml

    # 从各配置中提取节点信息（复杂，需要 YAML 处理工具）
    # ...
done

# 方式三：使用 Python/YAML 处理合并
# 适合需要精细控制的场景

# 合并后的策略组结构示例

proxy-groups:
  - name: "🚀 节点选择"
    type: select
    proxies:
      - ⚡ 自动选择
      - 🛫 机场A
      - 🛫 机场B
      - 🛫 机场C

  - name: "⚡ 自动选择"
    type: url-test
    proxies:
      - 🛫 机场A
      - 🛫 机场B
      - 🛫 机场C

  - name: "🛫 机场A"
    type: select
    use:
      - airport_a_provider   # 来自订阅 A 的节点

  - name: "🛫 机场B"
    type: select
    use:
      - airport_b_provider   # 来自订阅 B 的节点

  - name: "🛫 机场C"
    type: select
    use:
      - airport_c_provider   # 来自订阅 C 的节点

# 使用 Proxy Provider 管理各机场的节点
proxy-providers:
  airport_a:
    type: http
    url: https://airport1.com/subscription
    path: ./proxy_providers/airport_a.yaml
    interval: 3600

  airport_b:
    type: http
    url: https://airport2.com/subscription
    path: ./proxy_providers/airport_b.yaml
    interval: 3600

# 自定义 ACL 模板输出的完整 Clash 配置
# 文件名: /opt/subconverter/configs/my_custom.ini

[common]
port=7890
socks-port=7891
allow-lan=true
mode=rule
log-level=warning
ipv6=false
external-controller=127.0.0.1:9090
tcp-fast-open=true

[dns]
enable=true
ipv6=false
enhanced-mode=fake-ip
fake-ip-range=198.18.0.1/16
nameserver=223.5.5.5,119.29.29.29
fallback=1.1.1.1,8.8.8.8
fallback-filter=geoip:cn,ipcidr:240.0.0.0/4

[proxy_group]
🚀 节点选择,select
⚡ 自动选择,url-test
🇭🇰 香港节点,select
🇯🇵 日本节点,select
🇺🇸 美国节点,select
🎯 全球直连,select
🐟 漏网之鱼,select
🛑 广告拦截,select

[rule]
; 广告拦截
https://example.com/rules/reject.list,🛑 广告拦截

; 国内直连
https://example.com/rules/cn.list,🎯 全球直连
https://example.com/rules/direct.list,🎯 全球直连

; 代理规则
https://example.com/rules/gfw.list,🚀 节点选择
https://example.com/rules/proxy.list,🚀 节点选择

; 默认规则
[]FINAL,🐟 漏网之鱼

#!/usr/bin/env python3
# subscription_manager.py - 高级订阅管理器

import yaml
import requests
import base64
from datetime import datetime

class SubscriptionManager:
    def __init__(self, subconverter_host="http://127.0.0.1:25500"):
        self.host = subconverter_host

    def convert(self, sub_url, target="clash", config="ACL4SSR_Online.ini"):
        """转换单个订阅"""
        url_b64 = base64.b64encode(sub_url.encode()).decode()

        params = {
            "target": target,
            "url": url_b64,
            "config": config,
            "emoji": "true",
            "list": "true",
            "tfo": "true",
            "udp": "true",
        }

        resp = requests.get(f"{self.host}/sub", params=params)
        return resp.text

    def merge(self, subscriptions, output_path):
        """合并多个订阅为单个配置"""
        all_configs = []
        for name, url in subscriptions:
            config_text = self.convert(url, target="clash")
            config = yaml.safe_load(config_text)

            # 为节点名添加机场前缀，避免重名
            for proxy in config.get("proxies", []):
                proxy["name"] = f"[{name}] {proxy['name']}"

            all_configs.append(config)

        # 合并所有节点
        merged = {
            "port": 7890,
            "socks-port": 7891,
            "allow-lan": True,
            "mode": "rule",
            "log-level": "warning",
            "proxies": [],
            "proxy-groups": [
                {
                    "name": "🚀 节点选择",
                    "type": "select",
                    "proxies": [p["name"] for c in all_configs for p in c["proxies"]]
                }
            ],
            "rules": all_configs[0].get("rules", []) if all_configs else []
        }

        # 收集所有节点
        for config in all_configs:
            merged["proxies"].extend(config.get("proxies", []))

        # 写入文件
        with open(output_path, "w", encoding="utf-8") as f:
            yaml.dump(merged, f, allow_unicode=True, default_flow_style=False)

        print(f"✅ 合并完成: {output_path} ({len(merged['proxies'])} 个节点)")
        return output_path

    def generate_html_index(self, configs):
        """生成 HTML 索引页面（便于手机下载）"""
        html = f"""<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>我的订阅配置</title>
    <style>
        body {{ font-family: -apple-system, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }}
        h1 {{ color: #2c3e50; }}
        ul {{ list-style: none; padding: 0; }}
        li {{ margin: 10px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; }}
        a {{ color: #3498db; text-decoration: none; font-weight: 600; }}
        a:hover {{ text-decoration: underline; }}
        .updated {{ color: #7f8c8d; font-size: 12px; margin-top: 20px; }}
    </style>
</head>
<body>
    <h1>📱 我的订阅配置</h1>
    <ul>
"""

        for name, filename in configs:
            html += f'        <li><a href="{filename}">{name}</a></li>\n'

        html += f"""    </ul>
    <div class="updated">最后更新: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</div>
</body>
</html>"""

        return html


# 使用示例
if __name__ == "__main__":
    manager = SubscriptionManager()

    # 合并多个订阅
    subscriptions = [
        ("机场A", "https://airport1.com/sub"),
        ("机场B", "https://airport2.com/sub"),
    ]

    merged = manager.merge(subscriptions, "/var/www/subscriptions/merged.yaml")
    html = manager.generate_html_index([("合并订阅", "merged.yaml")])

    # 保存索引页
    with open("/var/www/subscriptions/index.html", "w", encoding="utf-8") as f:
        f.write(html)

    print("完成!")

# 检查容器是否运行
docker ps | grep subconverter

# 检查端口监听
ss -tlnp | grep 25500

# 直接测试转换服务
curl -v http://127.0.0.1:25500/

# 检查日志
docker logs subconverter --tail 50

# 检查生成的 YAML 格式是否正确
python3 -c "import yaml; yaml.safe_load(open('config.yaml'))"

# 在 Clash/Mihomo 客户端测试
# 观察客户端日志中的错误信息

# 常见问题:
# 1. 节点名重复 → 在 ACL 中开启去重
# 2. 协议不被支持 → 更新客户端或调整转换目标
# 3. 规则集 URL 无法访问 → 检查 VPS 是否能访问 GitHub
# 4. DNS 配置问题 → 手动覆盖 DNS 配置部分

# 修复方法: 调整 ACL 模板
# 或者在生成的配置上进行后处理

# 确保 VPS 能访问 GitHub
curl -I https://raw.githubusercontent.com/Loyalsoldier/clash-rules/release/reject.txt

# 如果无法访问，考虑使用镜像或 CDN
# 替换为 FastGit 等国内镜像
# https://raw.fastgit.org/Loyalsoldier/clash-rules/release/reject.txt

# 或者使用本地规则文件
# 1. 下载规则文件到本地
# 2. 在 subconverter 配置中使用本地路径

# 使用 sing-box 规则集（如果 sing-box 作为客户端）
# 格式与 Clash 有所不同，需要调整

# 在客户端配置中启用自动更新（Clash for Android）
# 1. 添加订阅配置
# 2. 设置更新间隔（推荐 6-12 小时）
# 3. 启用"自动更新"

# 使用 subconverter 的订阅链接格式：
https://your-subconverter-domain.com/sub?target=clashmeta&url=BASE64_URL&config=ACL4SSR_Online.ini&emoji=true&list=true&tfo=true&udp=true

# 客户端会周期性请求该 URL，获取最新配置