🔥 Why Sublink Worker + Cloudflare Worker?
Traditional subscription converters require self-hosted servers with high maintenance costs and unstable networks. Our solution leverages Cloudflare Worker‘s global serverless platform to deliver:
- ✅ Zero server costs: Runs entirely on Cloudflare’s edge network
- ⚡ Global acceleration: 300+ CDN nodes worldwide
- 🔒 Built-in security: DDoS protection + automatic HTTPS
- 🚀 5-minute deployment: No complex configurations
- 💡 Full customization: Rulesets & policy groups
📥 Step 1: Fork the GitHub Repo
- Go to: https://github.com/7Sageer/sublink-worker
- Click “Fork” (top-right)
🚀 Step 2: Deploy to Cloudflare Worker
- Click the blue “Deploy to Cloudflare” button in your forked repo (Requires linked Cloudflare/GitHub account)
- Configure deployment:
- Repository: Your forked repo
- Project Name:
sublink-worker
(recommended) - Build Command: Replace with:
npm run deploy
🌐 Step 3: Access Your Service
- Default URL:
https://[YOUR-WORKER-NAME].[YOUR-ACCOUNT].workers.dev
- Custom domain: Add under Workers >
Domains & Routes
🎨 Using the Web Interface
![Web UI][2]
Core Features:
- Import subscriptions:
-
Base64-encoded HTTP/HTTPS links
-
OR raw SS/Vmess/VLESS/Trojan links
- Select client:
-
SingBox / Clash / Xray / V2Ray
- Custom rules:
-
Presets (e.g., GFWList)
-
Custom
geo-site
/geo-ip
/domain-suffix
policies- Generate subscriptions:
-
Get converted links
-
Create short URLs
⚡ Advanced Usage
API Conversion Example:
curl -X POST "https://your-worker.dev/convert" \
-H "Content-Type: application/json" \
-d '{
"url": "https://original-sub.com/link",
"target": "clash",
"config": {
"ruleset": ["geosite:geolocation-!cn", "ip-cidr:8.8.8.8/32"]
}
}'
Supported Protocols:
Protocol | Encryption / Security | Supported |
---|---|---|
ShadowSocks | aes-256-gcm / chacha20 / etc. | ✅ |
VMess | auto / aes-128-gcm / etc. | ✅ |
VLESS | none / reality / etc. | ✅ |
Trojan | TLS + Password | ✅ |
Hysteria2 | QUIC | ✅ |
TUIC | UDP | ✅ |
❓ Troubleshooting
- Short URLs failing? → Bind a KV namespace to your Worker
npm not found
error? → Ensure build command isnpm run deploy
- Update to new version:
git remote add upstream https://github.com/7Sageer/sublink-worker
git pull upstream main
# Push updates to trigger auto-redeploy
💡 Pro Tips
- Set
ACCESS_TOKEN
in environment variables to prevent abuse - Use custom domains to avoid workers.dev blocks
- Regularly update rulesets via GitHub
- Client configuration example (Clash):
proxies:
- name: "My_Server"
type: vmess
server: your-server.com
port: 443
uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
tls: true
network: ws
ws-path: /your-path
🌟 Conclusion
You now have a permanently free subscription converter with:
- Zero maintenance serverless architecture
- Full rule customization
- Global CDN acceleration
Deploy your personal conversion hub today!
Project URL: https://github.com/7Sageer/sublink-worker