website·Indexed 31 days ago
https://docs.sspanel.ioA powerful PHP-based proxy service management panel supporting multiple protocols including Shadowsocks, V2Ray, and Trojan. The documentation covers installation on Debian, Ubuntu, and CentOS, system optimization for PHP 8.4, database and Redis configuration, subscription system management, and integration with mail services and IM platforms like Telegram.
SSPanel-UIM is a mature, open-source proxy management panel designed as an enterprise-level solution. It is built on an MVC architecture for maintainability and stability. Key functional systems include:
It supports a plugin system for customization, various themes, and is compatible with PHP 8.4.
SSPanel-UIM is a PHP-based management panel for proxy services. Its core capabilities include:
SSPanel-UIM provides a comprehensive suite of tools for commercial proxy service operation:
SSPanel-UIM is built on a high-performance architecture with the following technical specifications:
For first-time users, the recommended sequence for deployment and setup is:
Port offset allows the port the user connects to (provided in the subscription) to differ from the port the node backend is actually listening on. This is typically used for relay/forwarding scenarios.
How it works:
offset_port_user: The port delivered to the user via the subscription.offset_port_node: The port the node backend listens on (informed via WebAPI).Protocol Support:
Example Scenario (Relay):
User $\rightarrow$ Relay Machine (Port 443) $\rightarrow$ Exit Node (Port 8443).
Configuration: offset_port_user: 443, offset_port_node: 8443.
Implementation on relay machine: iptables -t nat -A PREROUTING -p tcp --dport 443 -j DNAT --to-destination <Exit_Node_IP>:8443.
| Format | Path Segment ({subtype}) | Required Config | Description |
|---|---|---|---|
| JSON | json | N/A | General JSON with user info and nodes |
| Clash | clash | N/A | YAML format with proxy groups and rules |
| SingBox | singbox | N/A | JSON format for sing-box core |
| V2Ray | v2ray | $_ENV['enable_v2_sub'] | Base64 encoded vmess:// links |
| V2RayJson | v2rayjson | N/A | Full V2Ray JSON configuration |
| Shadowsocks | ss | $_ENV['enable_ss_sub'] | Base64 encoded SS nodes |
| SIP002 | sip002 | $_ENV['enable_ss_sub'] | Standard ss:// links (SIP002) |
| SIP008 | sip008 | N/A | JSON format with extra node info |
| Trojan | trojan | $_ENV['enable_trojan_sub'] | Base64 encoded trojan:// links |
To add a new node, navigate to Node Management $\rightarrow$ Node List and click Add Node. The following basic fields are required:
Payment gateways are managed via the admin panel plugins system rather than configuration files. Supported types include traditional (Alipay, WeChat), international (Credit Card, PayPal), cryptocurrency, and aggregated payment platforms.
Steps to configure:
// For most services (where user IPs change frequently):
$_ENV['enable_login_bind_ip'] = false; // Disable IP binding
$_ENV['enable_login_bind_device'] = true; // Keep device binding
$_ENV['rememberMeDuration'] = 30; // 30 days remember me
// For high-security services:
$_ENV['enable_login_bind_ip'] = true; // Enable IP binding
$_ENV['enable_login_bind_device'] = true; // Enable device binding
$_ENV['rememberMeDuration'] = 7; // 7 days remember meemail_queue table) to process emails. A cron job must be configured to run every 5 minutes to trigger the queue processor and send pending emails. It is recommended to redirect output to a log file for troubleshooting.# Edit crontab
crontab -e
# Add the following line to run every 5 minutes
*/5 * * * * /usr/bin/php /var/www/sspanel/xcat Cron >> /var/log/sspanel-cron.log 2>&1