English | 简体中文

---

📖 Project Overview

SublinkPro is a deeply refactored and enhanced project based on the excellent open source projects sublinkX and sublinkE. Thanks to the original authors for their work and contributions.

• 🎨 Frontend framework: Based on Berry Free React Material UI Admin Template
• ⚡ Backend stack: Go + Gin + Gorm
• 🔐 Default account: admin / 123456, change it immediately after installation
• 💻 Demo: https://demo.sublinkpro.dpdns.org/, username: admin, password: 123456

[!WARNING] ⚠️ This project is not database compatible with the original projects. Don't mix their databases.

⚠️ Don't use this project, or any derivative of it, for activities that violate the laws and regulations of your location or the location of the users you serve. This project is for personal development, learning, and exchange only.

---

✨ Highlights

---

🚀 Quick Start

Docker Compose, recommended

[!IMPORTANT] Runtime data is stored in these directories by default. Keep them during upgrades and migrations:

• ./db: database, configuration files, GeoIP, and other local data
• ./template: template files
• ./logs: runtime logs

Create docker-compose.yml:

services:
  sublinkpro:
    image: zerodeng/sublink-pro
    container_name: sublinkpro
    ports:
      - "8000:8000"
    volumes:
      - "./db:/app/db"
      - "./template:/app/template"
      - "./logs:/app/logs"
    restart: unless-stopped

Start the service:

docker-compose up -d

Open http://localhost:8000 and sign in with admin / 123456.

SQLite is used by default. To switch to MySQL or PostgreSQL, set the database connection through SUBLINK_DSN, dsn: in the config file, or the --dsn command line flag. See ⚙️ Configuration for examples.

[!NOTE] Even when SUBLINK_WEB_BASE_PATH is configured to hide the admin UI entry, API paths (/api/*) and subscription or share paths (/c/*) stay at the root path. This is a project specific frontend and backend integration rule.

[!TIP] For more install methods, including Docker, one line scripts, updates, and upgrades, see the 📦 Installation Guide.

[!TIP] The Docker image includes cloudflared. After signing in, open User Center -> Cloudflare Tunnel, enter the token, and start it. When auto connect is enabled, the Tunnel connects when the service starts.

Migrate from SQLite to MySQL / PostgreSQL

If your earlier instance used SQLite and you now want to migrate to MySQL or PostgreSQL, use this flow:

1. Sign in to the old SQLite instance, open System Backup from the avatar menu in the upper right, and export backup.zip.
2. Configure the DSN for MySQL or PostgreSQL in the new instance, and make sure the target database is a fresh empty database.
3. Start the new instance and open Settings -> Data Migration.
4. Upload the backup.zip exported from the old instance.
5. Choose whether to migrate AccessKey and subscription access logs, then start the migration.
6. After migration completes, manually restart the project instance, then sign in again and check the data.

[!IMPORTANT] Using backup.zip is recommended. Uploading a .db file directly migrates database records only and won't restore the template directory.

[!NOTE] If you migrate AccessKey, make sure both old and new instances use the same API encryption key; otherwise old API Keys may no longer work.

[!TIP] If migration finishes with “N warnings”, open the corresponding “Database Migration” task in Task Center to view details.

---

📖 Documentation

🔧 Installation and Configuration

✨ Feature Guides

👨‍💻 Developers

---

📡 Multi Protocol Support

Hysteria2 links support both hy2:// and hysteria2://. For userpass authentication, hy2://user:[email protected]:443 and hy2://user%[email protected]:443 both preserve the complete user:pass credential. Percent-encode reserved characters in credentials; URI components are decoded once, including when links are re-exported.

[!NOTE] Mieru currently supports Clash/mihomo YAML import and export only. Official Mieru has mieru:// and mierus:// share links, but does not define a general URL schema suitable for field by field editing. For raw editing and Clash/mihomo import write back, SublinkPro uses an internal editable form: mieru://username:password@server:port?...#name, with port ranges written as portRange=2090-2099. v2ray and Surge don't support Mieru in SublinkPro. Subscription output skips that protocol instead of converting it to a downgraded form.

[!NOTE] Snell supports Clash/mihomo and Surge output only. Snell has no official share link schema, so SublinkPro uses an internal editable form for raw editing and Clash/mihomo/Surge import write back: snell://server:port?psk=xxx&version=3&obfs=http&obfs-host=xxx#name. v2ray does not support Snell in SublinkPro; subscription output skips it instead of converting it to a downgraded form.

[!NOTE] OpenVPN supports importing and exporting Mihomo/Clash proxies: YAML entries. SublinkPro stores them in an internal round-trip form, openvpn://server:port?...#name; this is not an official OpenVPN share-link standard and does not add direct .ovpn file import. Certificate and private-key material is URL-encoded, not encrypted, in the stored node link, so protect database access and do not share the internal link.

---

🖼️ Preview

Show or hide screenshots

---

📊 Project Stats

---

🤝 Contributing and Support

If this project helps you, you are welcome to:

• ⭐ Star the project
• 🐛 Open an Issue for bugs or suggestions
• 🔧 Submit a Pull Request
• 📖 Improve the docs and tutorials

🌟 Recommended services

If you need to buy a server, you can support the maintainer through the links below. Purchases through these links may provide commission rewards to the maintainer. Check official pages for exact pricing, promotion eligibility, network performance, and renewal rules.

• BandwagonHost: premium routes, multiple data centers, and CN2 GIA options. Good for high quality route servers, or as a stable landing server with other nodes. Highlights: many VPS locations, CN2 GIA optimized routes, quality route machines.
• Vultr: many regions, hourly billing, IP and region changes, starting at $2.5 per month. Good for websites, AI service hosting, route servers, and landing servers. Highlights: many regions, hourly billing, low price, stable service, IPv6 only machines.
• Aliyun: 99 RMB per year server offer with the same price for new purchase and renewal. Good for domestic deployment and testing, including newapi and SublinkPro. Registration through the link may provide discounts, including AI related discounts. Highlights: suitable for China based deployment and development testing, 99 RMB per year new purchase and renewal, discount coupons.

🙏 Acknowledgements

Thanks to these open source projects:

• sublinkX / sublinkE, original projects
• Berry Free React Admin Template, frontend template
• Mihomo, proxy core

---