Go to file
2026-04-30 00:49:52 +08:00
.docker fix(caddy): preserve X-Forwarded-For chain so Laravel TrustProxies resolves real client IP 2026-04-23 11:39:58 +08:00
.github ci: remove image signing 2026-03-15 10:28:49 +08:00
app refactor(middleware): split V2 server middleware to drop node_type 2026-04-23 19:24:34 +08:00
bootstrap Initial commit 2023-11-17 14:44:01 +08:00
config refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
database fix: backfill utls for legacy vless reality nodes 2026-04-20 00:08:00 +08:00
docs Update Docker commands for V2board Dev migration 2026-04-30 00:49:52 +08:00
plugins refactor: core plugins to plugins-core 2026-04-18 23:31:59 +08:00
plugins-core refactor: core plugins to plugins-core 2026-04-18 23:31:59 +08:00
public feat(admin): batch node-machine binding & frontend update 2026-04-18 19:38:31 +08:00
resources feat: email template management with DB override, modern mail redesign 2026-04-18 15:41:23 +08:00
routes feat: machine mode, ECH subscriptions, batch ops & security hardening 2026-04-17 03:02:53 +08:00
storage feat: add plugin upload functionality and optimize plugin logic 2025-01-26 03:58:28 +08:00
tests/Feature/Server refactor(middleware): split V2 server middleware to drop node_type 2026-04-23 19:24:34 +08:00
theme fix: iOS Safari autofill not filling email field (Fixes #330) 2026-03-28 07:41:57 +08:00
.dockerignore feat: new xboard 2025-01-21 14:57:54 +08:00
.editorconfig Initial commit 2023-11-17 14:44:01 +08:00
.env.example feat: introduce WebSocket sync for XBoard nodes 2026-03-15 09:49:11 +08:00
.gitattributes Initial commit 2023-11-17 14:44:01 +08:00
.gitignore refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
.gitmodules Use submodule for admin assets 2026-03-11 04:52:06 +08:00
artisan Initial commit 2023-11-17 14:44:01 +08:00
compose.1panel.sample.yaml refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
compose.host.sample.yaml refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
compose.sample.yaml refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
compose.split.sample.yaml refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
composer.json feat: introduce WebSocket sync for XBoard nodes 2026-03-15 09:49:11 +08:00
composer.lock fix: commit composer.lock for reproducible Docker builds 2026-04-18 16:56:41 +08:00
Dockerfile refactor: all-in-one docker deployment with auto-tuned resources and per-mode compose templates 2026-04-19 21:18:15 +08:00
init.sh Use submodule for admin assets 2026-03-11 04:52:06 +08:00
LICENSE Initial commit 2023-11-17 14:44:01 +08:00
package.json feat: new xboard 2025-01-21 14:57:54 +08:00
phpstan.neon fix: resolve PHPStan static analysis warnings 2025-05-07 19:48:19 +08:00
README.md docs: update readme 2026-04-19 21:57:56 +08:00
update.sh fix(update): avoid duplicate safe.directory entries for repo and admin submodule 2026-04-09 20:31:19 +08:00

Xboard

Telegram PHP MySQL License

📖 Introduction

Xboard is a modern panel system built on Laravel 11, focusing on providing a clean and efficient user experience.

✨ Features

  • 🚀 Built with Laravel 12 + Octane for significant performance gains
  • 🎨 Redesigned admin interface (React + Shadcn UI)
  • 📱 Modern user frontend (Vue3 + TypeScript)
  • 🐳 Ready-to-use Docker deployment solution
  • 🎯 Optimized system architecture for better maintainability

🚀 Quick Start

git clone -b compose --depth 1 https://github.com/cedar2025/Xboard && \
cd Xboard && \
docker compose run -it --rm \
    -e ENABLE_SQLITE=true \
    -e ENABLE_REDIS=true \
    -e ADMIN_ACCOUNT=admin@demo.com \
    xboard php artisan xboard:install && \
docker compose up -d

After installation, visit: http://SERVER_IP:7001
⚠️ Make sure to save the admin credentials shown during installation

📖 Documentation

🔄 Upgrade Notice

🚨 Important: This version involves significant changes. Please strictly follow the upgrade documentation and backup your database before upgrading. Note that upgrading and migration are different processes, do not confuse them.

Development Guides

Deployment Guides

Migration Guides

🛠️ Tech Stack

  • Backend: Laravel 11 + Octane
  • Admin Panel: React + Shadcn UI + TailwindCSS
  • User Frontend: Vue3 + TypeScript + NaiveUI
  • Deployment: Docker + Docker Compose
  • Caching: Redis + Octane Cache

📷 Preview

Admin Preview

User Preview

⚠️ Disclaimer

This project is for learning and communication purposes only. Users are responsible for any consequences of using this project.

❤️ Support The Project

If this project has helped you, donations are appreciated. They help support ongoing maintenance and would make me very happy.

TRC20: TLypStEWsVrj6Wz9mCxbXffqgt5yz3Y4XB

🌟 Maintenance Notice

This project is currently under light maintenance. We will:

  • Fix critical bugs and security issues
  • Review and merge important pull requests
  • Provide necessary updates for compatibility

However, new feature development may be limited.

🔔 Important Notes

  1. Restart required after modifying admin path:
docker compose restart
  1. For aaPanel installations, restart the Octane daemon process

🤝 Contributing

Issues and Pull Requests are welcome to help improve the project.

📈 Star History

Stargazers over time