Lipanel: A Lightweight Single-File Linux Panel of Just 9.6 MB, with Core Features Built In and On-Demand Extensibility
The motivation behind developing Lipanel is simple: some server panels on the market become increasingly bloated as features are added, while others use relatively closed plugin ecosystems.
We wanted to create a Linux panel with a sufficiently lean core, support for plugin-based extensions, and single-file deployment.
Completed Features
The following features have all been completed and verified through actual operation:
-
Core Features
- systemd service management
- File management
- Website management, including Nginx static sites and reverse proxying
- Automatic application and renewal of Let’s Encrypt SSL certificates
-
Plugin System
- Communication via Unix Socket and HTTP
- Support for permission declarations and audit logs
- Plugin frontends use iframe sandbox isolation by default
- Plugins cannot read cookies or directly call the panel API
-
Security Mechanisms
- Three-level path security validation
- Commands are executed uniformly by slicing argv arguments, without concatenating Shell commands
- All write operations are recorded in audit logs
- Permissions are checked before sensitive operations are executed
Tech Stack
- Go
- Vue 3
- Vite
- Naive UI
The generated single binary is currently approximately 9.6 MB. It is built as a fully static program with CGO_ENABLED=0 and requires no Node.js, Python, or Java dependencies at runtime.
Implementation Details
- After modifying the Nginx configuration, the system automatically runs
nginx -tfor validation. If validation fails, it automatically rolls back the changes. - SSL certificates are validated using the
webrootmethod, without occupying port 80 or modifying the existing Nginx configuration without permission. - The boundaries of the permission model are clearly documented in the code comments: Lipanel manages a “panel forwarding channel” and does not describe it as a kernel-level sandbox.
Development Roadmap
In Development
Software store, planned to support:
- One-click installation of PHP, Nginx, and MySQL
- Specifying installation versions
- Multi-source fallback
Future Plans
- App store
- Docker plugin
- Plugin marketplace
Project Link
github.com/LiStudioorg/lipanel
Contributing
Currently under active development
Feel free to try it out and submit Issues. Developers are also welcome to participate in developing official plugins.
Lipanel will not create paywalls by cutting core features; its core features will always remain open source under the AGPL-3.0 license.