Lares Panel
Lares Panel by ThoCode · English: README.en.md
Hosting control panel viết bằng TypeScript cho VPS Ubuntu/Debian: quản lý website WordPress và Next.js (cùng PHP thuần, HTML tĩnh), SSL, log traffic, database, sao lưu, và chuyển site từ VPS/panel khác về.
Tài liệu: Cài đặt · Bảo mật · Xử lý sự cố · Sao lưu · Khách liên hệ · Câu hỏi thường gặp · Thay đổi (CHANGELOG)
Beta: Lares đang ở giai đoạn 0.x beta. Hãy sao lưu và thử trên VPS không quan trọng trước khi dùng cho site thật.
Hỏi đáp, góp ý: GitHub Discussions · Báo lỗi: Issues · Báo lỗ hổng bảo mật: SECURITY.md
| Cập nhật WordPress an toàn | Trình tạo giao diện |
|---|
| |
| Chuyển site từ VPS / panel khác | Khách liên hệ |
| |
AI viết bài chuẩn SEO rồi đăng thẳng lên WordPress (tua nhanh):
Cài đặt
Hệ điều hành được hỗ trợ: Ubuntu 22.04 / 24.04, Debian 12 (x86_64, arm64). Debian 13 cài được nhưng kèm cảnh báo "chưa kiểm thử". Ubuntu 20.04 và Debian 11 đã hết vòng đời nên installer từ chối cài, trừ khi thêm --force-unsupported. Chạy bằng root:
curl -sSL https://lares.thocode.dev/install | sudo bash
# tuỳ chọn:
curl -sSL https://lares.thocode.dev/install | sudo bash -s -- --port 9443 --php "8.3 8.2"
# bộ cài in tiếng Anh, panel mặc định tiếng Anh:
curl -sSL https://lares.thocode.dev/install | sudo bash -s -- --lang en
lares.thocode.dev/install chuyển hướng tới install.sh trên GitHub. Nếu không truy cập được tên miền này, dùng link gốc: https://raw.githubusercontent.com/tampham92/lares/main/install.sh.
Script cài Nginx, MariaDB, PHP-FPM (nhiều phiên bản), Node.js LTS, Certbot, WP-CLI. Sau đó nó tải và build Lares, tạo service lares (systemd), rồi in ra URL https://IP:8686 cùng mật khẩu admin. Chạy lại cùng lệnh để nâng cấp; dữ liệu và mật khẩu vẫn được giữ. Danh sách đầy đủ các tuỳ chọn (--port, --php, --no-telemetry, --force-unsupported…) có trong docs/vi/installation.md.
Ngay sau khi cài, port 8686 mở cho mọi IP. Hãy đổi mật khẩu, bật xác thực 2 lớp và giới hạn IP theo hướng dẫn Bảo mật.
Ngôn ngữ
Lares có tiếng Việt (mặc định) và tiếng Anh.
--lang vi|en chọn ngôn ngữ của bộ cài và ngôn ngữ mặc định của panel (lưu thành LARES_LANG trong /etc/lares/lares.env, dùng cho log khởi động và lệnh sudo lares). Khi nâng cấp, ngôn ngữ đã lưu được giữ nếu không truyền --lang. uninstall.sh cũng nhận --lang.- Giao diện web có nút chọn ngôn ngữ ở thanh bên và trang đăng nhập. Lần đầu mở, panel theo ngôn ngữ của trình duyệt (trình duyệt không dùng tiếng Việt hay tiếng Anh thì hiện tiếng Việt); lựa chọn được lưu trên trình duyệt đó.
VPS đã có sẵn Nginx / MySQL / MariaDB / Apache
Installer phát hiện và dùng lại các dịch vụ đang có, không cài đè:
| Đang có | Cách xử lý |
|---|
| MariaDB / MySQL / Percona (cài qua apt hoặc do panel khác tự build) | Không cài server thứ hai; tạo user lares riêng. Đăng nhập quản trị qua unix socket, /etc/mysql/debian.cnf, hoặc --mysql-root-password 'xxx' nếu root có mật khẩu. Không xoá DB test hay user nào |
| nginx (apt) | Dùng lại; giữ nguyên vhost và site default. Bỏ qua catch-all nếu server đã có default_server. Nếu nginx -t đang lỗi thì dừng và yêu cầu sửa trước |
| Web server khác đang giữ port 80/443 (Apache, OpenLiteSpeed, nginx của aaPanel…) | Chế độ cùng tồn tại: vẫn cài nginx của Lares nhưng chưa chạy. Bạn vẫn tạo/chuyển site bình thường; khi sẵn sàng, dừng web server cũ và chạy systemctl enable --now nginx |
| PHP-FPM | Dùng lại, không sửa php.ini của các phiên bản đã có |
Node.js cũ hơn 20 trong /usr/bin | Được nâng lên Node 22 (Lares cần ≥ 20). Node cài qua nvm không bị ảnh hưởng |
Mặc định script cài tag phát hành mới nhất (vX.Y.Z) của https://github.com/tampham92/lares. Muốn dùng fork, nhánh main hoặc tag khác: --repo <git-url> --branch <nhánh-hoặc-tag>, hoặc --tarball <url .tar.gz>.
Cập nhật Lares có mất dữ liệu không?
Không. Chạy lại đúng lệnh cài đặt; installer nhận ra /etc/lares/lares.env nên chuyển sang chế độ nâng cấp:
- Chỉ thay mã nguồn trong
/opt/lares/src, build lại, khởi động lại service lares (panel gián đoạn vài giây, website vẫn chạy bình thường).
- Giữ nguyên: website trong
/var/www, database MySQL, vhost nginx, SSL, service Next.js, tài khoản admin, khoá giải mã và dữ liệu SQLite trong /var/lib/lares. Cấu trúc database của Lares được tự nâng cấp khi khởi động.
- Trước khi khởi động lại, installer tự sao lưu
/etc/lares + database SQLite + template riêng vào /var/lib/lares/backups/ (giữ 5 bản gần nhất).
- Đừng sửa trực tiếp file trong
/opt/lares/src (bị ghi đè khi cập nhật); template riêng đặt ở /var/lib/lares/templates/.
- Port, phiên bản PHP, ngôn ngữ và lựa chọn thống kê ẩn danh đã chọn lúc cài được giữ nguyên, trừ khi bạn truyền lại
--port/--php/--lang.
- Phiên bản đang chạy hiện ở cuối thanh bên. Mỗi ngày panel kiểm tra các tag phát hành
vX.Y.Z trên GitHub, khi có bản mới sẽ hiện Có bản mới x.y.z. Nâng cấp bằng nút trong Cài đặt → Cập nhật hoặc bằng lệnh trên; tắt việc kiểm tra cũng ở đó. Danh sách thay đổi: CHANGELOG.md.
Tài khoản quản trị
install.sh in mật khẩu admin một lần duy nhất. Mật khẩu chỉ được lưu dưới dạng bcrypt trong /var/lib/lares/lares.db; bản gốc bị xoá khỏi lares.env ngay sau khi cài.
sudo lares users # liệt kê tài khoản
sudo lares reset-password # đặt lại mật khẩu admin (ngẫu nhiên, in ra màn hình)
sudo lares reset-password admin --password 'MatKhauMoi123' # cũng mở khoá đăng nhập và đăng xuất các phiên của user đó
sudo lares disable-2fa [user] # tắt xác thực 2 lớp khi mất điện thoại
sudo lares allowlist show|add <ip/cidr>|remove <ip/cidr>|clear # giới hạn IP vào trang quản trị
Đổi mật khẩu trên giao diện: Cài đặt → Đổi mật khẩu quản trị.
Gỡ cài đặt
# Gỡ panel, GIỮ các website đang chạy (cài lại sẽ nhận lại site):
curl -sSL https://lares.thocode.dev/uninstall | sudo bash
# Xoá sạch panel + mọi site, database, SSL, log do Lares tạo (hỏi xác nhận bằng cách gõ XOA; với --lang en thì gõ DELETE):
curl -sSL https://lares.thocode.dev/uninstall | sudo bash -s -- --purge
Cả hai chế độ đều không gỡ nginx/MariaDB/MySQL/PHP/Node.js, và không động vào site hay database không do Lares tạo (kể cả database "dùng chung" với panel khác). Bản sao lưu site trong /var/backups/lares luôn được giữ lại; tự xoá nếu không cần.
Thống kê ẩn danh (telemetry)
Để biết số máy đang dùng Lares và cần hỗ trợ phiên bản/HĐH nào, install.sh gửi một ping khi cài và khi nâng cấp, còn panel gửi một heartbeat mỗi ngày tới https://lares.thocode.dev/ping (timeout 3 giây, lỗi thì bỏ qua). Ping chỉ gồm:
- mã cài đặt ngẫu nhiên (UUID tạo một lần, lưu ở
/etc/lares/install-id)
- phiên bản Lares, sự kiện (
install / upgrade / heartbeat)
- tên và phiên bản HĐH (vd
ubuntu 24.04), kiến trúc CPU (amd64/arm64), ngôn ngữ panel
Không bao giờ gửi IP, tên miền, hostname, số lượng site hay bất kỳ dữ liệu nào của site. Cách tắt: thêm --no-telemetry khi cài/nâng cấp, hoặc đặt LARES_TELEMETRY=0 trong /etc/lares/lares.env rồi systemctl restart lares. Chi tiết và mã nguồn liên quan: docs/vi/installation.md.
Tính năng
| Nhóm | Chi tiết |
|---|
| Website | Thêm/xoá/tạm ngưng site, alias, đổi phiên bản PHP. Loại site:WordPress (tự tải WP, tạo DB, wp-config, wp core install nếu nhập admin), Next.js (systemd service + Nginx reverse proxy, tự cấp port, clone từ Git, build/restart), PHP, HTML tĩnh |
| Giao diện mẫu | Khi tạo site WordPress hoặc HTML tĩnh, chọn giao diện dựng sẵn (hiện có Bất động sản, Doanh nghiệp, Spa, Nhà hàng, Landing page bán hàng, xem trước ngay trong panel), chỉ cần nhập tên thương hiệu, SĐT, email, địa chỉ. HTML tĩnh: trang hoàn chỉnh, responsive, có lọc dự án và form liên hệ. WordPress: block theme riêng kèm nội dung mẫu thật (bài dự án có ảnh, trang Giới thiệu/Liên hệ, menu, trang chủ), sửa được trong wp-admin; tài khoản admin tạo tự động. Thêm mẫu riêng vào /var/lib/lares/templates/ trên VPS (giữ nguyên khi cập nhật), xem templates/README.md |
| Site không cần tên miền | Nhập localhost (hoặc để trống) thay cho tên miền: Lares tự cấp port (từ 8001), nginx lắng nghe port đó, truy cập qua http://IP-VPS:8001. Tự mở port trên ufw nếu đang bật. Khi giao diện đã xong, bấm Gán tên miền thật trong trang site: vhost chuyển sang tên miền, port được đóng, log traffic giữ nguyên, WordPress được đổi lại toàn bộ URL. Sau đó cài SSL (WordPress tự chuyển URL sang https://) |
| Nhân bản site | Tab Nhân bản trong trang site: tạo bản sao sang tên miền khác hoặc port mới (làm staging, thử plugin/giao diện). Sao chép toàn bộ thư mục site và database sang database mới (user/mật khẩu mới). WordPress: wp-config trỏ sang database mới, toàn bộ URL đổi sang địa chỉ mới. Laravel/PHP: cập nhật DB_*, APP_URL trong .env. Next.js: service riêng trên port nội bộ mới. Site nguồn không bị thay đổi, lỗi giữa chừng thì tự rollback |
| Viết bài AI (WordPress) | Tab Viết bài AI trong site WordPress: nhập chủ đề + từ khoá, AI (Claude, Gemini hoặc OpenAI/API tương thích) viết bài chuẩn SEO: tiêu đề ≤ 60 ký tự, slug, meta description, H2/H3, FAQ, liên kết nội bộ tới bài sẵn có. Xem trước, sửa, bảng kiểm tra SEO cập nhật trực tiếp, rồi lưu nháp hoặc đăng thẳng (kèm danh mục, thẻ, meta cho Yoast SEO / Rank Math). Cần wp-cli để đăng |
| Đăng nhập WP Admin một chạm |
Chuyển site từ VPS / panel khác
Chuyển site → nhập VPS nguồn (IP, SSH user, mật khẩu hoặc private key, sudo), chọn panel nguồn → Quét site → chọn site và tuỳ chỉnh → Bắt đầu.
Panel được hỗ trợ và tự nhận diện: aaPanel, CyberPanel, HestiaCP/VestaCP, cPanel, DirectAdmin, CloudPanel, Plesk, Webinoly, Lares (chuyển sang VPS mới), VPS thuần Nginx/Apache, hoặc nhập thủ công.
Với mỗi site:
- Chuẩn bị: kiểm tra thư mục nguồn, tên miền đích, đăng nhập DB nguồn, ước lượng dung lượng, chọn cách truyền.
- Dump & nén database:
mysqldump --single-transaction --routines --triggers | pigz/gzip. Nếu user không có quyền dump routine thì tự dump lại mà không kèm routine.
- Nén mã nguồn:
tar | gzip, bỏ qua các đường dẫn trong excludes (wp-content/cache, node_modules, .next, addon domain lồng bên trong...).
- Đồng bộ: archive (nén trên nguồn → SFTP, kiểm tra sha256) hoặc stream (nén và truyền thẳng qua SSH, không cần chỗ trống trên nguồn). Chế độ auto chọn theo dung lượng trống.
- Kiểm tra toàn vẹn: sha256,
gzip -t, file dump phải có dòng Dump completed.
- Tạo site, khôi phục file, import DB vào database mới với user riêng của site. Tự bỏ
DEFINER và đổi collation MySQL 8 ↔ MariaDB.
- Cấu hình lại: sửa
DB_* trong wp-config.php/.env, search-replace tên miền WordPress bằng wp-cli nếu đổi domain. Với Next.js: install, build rồi chạy service.
- Hoàn tất & dọn dẹp: phân quyền, reload nginx, xoá file tạm ở cả hai phía (file chứa mật khẩu DB luôn bị xoá). Nếu lỗi, tự rollback site/DB vừa tạo.
Tiến trình được cập nhật realtime (SSE), có huỷ và chạy lại các site lỗi. Dữ liệu trên nguồn không bị thay đổi.
Khi panel nguồn chạy chung VPS với Lares
Lares nhận ra trường hợp này qua machine-id hoặc IP cục bộ, kể cả khi bạn nhập IP public của chính VPS:
- Bỏ SSH, làm việc trực tiếp trên máy. File được copy thẳng, không nén và không truyền qua mạng.
- Database mặc định được dump sang database mới để site cũ vẫn chạy song song. Nếu cùng một MySQL server, có thể chọn dùng lại database cũ (Lares kiểm tra
@@hostname/@@port/@@datadir). Database dùng lại không bao giờ bị Lares xoá, và cũng không được search-replace để tránh làm hỏng site nguồn.
- Cảnh báo khi port 80 đang do web server của panel cũ giữ (ví dụ OpenLiteSpeed của CyberPanel, nginx của aaPanel), hoặc khi có nguy cơ trùng
server_name.
- Webinoly để
wp-config.php bên ngoài htdocs: file này được tự mang vào thư mục site.
- Lares trên VPS khác: danh sách site đọc thẳng từ database của Lares nguồn (thư mục, loại app, phiên bản PHP), kể cả site đã đổi tên miền nhưng vẫn ở thư mục
siteNNNN.localhost. Site còn chạy theo port (chưa có tên miền) bị bỏ qua: gán tên miền trên Lares nguồn trước, hoặc nhập thủ công.
Phát triển
npm install
npm run dev # server :8686 (tsx watch) + web :5173 (Vite, proxy /api)
npm test # unit test parser (nginx/apache/cPanel/Hestia, wp-config, .env, access log)
npm run typecheck
npm run build
Nếu máy có nginx (brew install nginx), Lares tự chạy một nginx dev (không cần root) phục vụ các site chạy theo port, nên xem được site HTML tại http://localhost:8001. Site WordPress/PHP chỉ chạy thật trên VPS (cần PHP-FPM + MySQL).
Ngoài Linux, Lares luôn chạy chế độ dry-run: mọi lệnh thay đổi hệ thống (nginx reload, systemctl, certbot, mysql, chown) chỉ được ghi log, còn file site/vhost được ghi vào ./data. Mật khẩu admin lần đầu được in ra log (hoặc đặt LARES_ADMIN_PASSWORD). Các biến cấu hình có trong .env.example.
Cấu trúc
packages/shared Zod schema + kiểu dữ liệu dùng chung server/web
apps/server Fastify API (chạy bằng root trên VPS)
src/executors Chạy lệnh local / SSH (ssh2): stream, SFTP, huỷ, ghim host key
src/services nginx, php, mysql, sites, nodeapp (Next.js), wordpress, ssl, logs, tasks
src/migration panels/ (adapter + parser), appDetect, source (kết nối/quét), runner (pipeline), repo
src/routes REST + SSE
templates/ Giao diện mẫu: _base.css, _wp.css + <id>/{template.json, style.css, index.html, wordpress/home.html}
apps/web React 19 + Vite + TanStack Query
install.sh Bộ cài 1 lệnh (uninstall.sh: gỡ cài đặt)
docs/ Tài liệu (vi/, en/)
ops/telemetry-worker Cloudflare Worker nhận bộ đếm cài đặt ẩn danh (/ping)
.github/workflows CI: typecheck, test, build, ShellCheck, chạy thử install.sh trên Ubuntu 22.04/24.04
Nơi lưu trên VPS: dữ liệu /var/lib/lares (SQLite, secret), site /var/www/<domain>/{public_html|app}, log /var/log/lares/sites/<domain>/, vhost /etc/nginx/sites-available/<domain>.conf, service Next.js lares-app-<domain>.service.
Bảo mật
- Mật khẩu SSH/DB nguồn, mật khẩu DB và biến môi trường Next.js được mã hoá AES-256-GCM trong SQLite.
- Mọi tham số shell đều được quote; tên miền, đường dẫn và excludes được validate bằng Zod ở cả server lẫn web.
- Code và dump SQL từ site migrate về được coi là không tin cậy: import SQL bằng user riêng của site (không dùng root), wp-cli/artisan/npm chạy bằng user riêng của site, gỡ bit setuid/setgid, giải nén với
--no-same-owner.
- Cách ly từng site: mỗi site có user Linux và PHP-FPM riêng trong sandbox systemd, tường lửa chặn gửi mail trực tiếp và metadata của cloud. Một site bị nhiễm mã độc không đọc hay sửa được site khác. Chi tiết: docs/vi/security.md.
- Quét mã độc, cách ly khẩn, dọn site: quét hằng ngày (đối chiếu checksum wordpress.org, webshell, admin lạ...), một nút cách ly khẩn, dọn bằng cách cài lại code gốc, khoá code theo site. Chi tiết: docs/vi/security.md.
- Host key SSH được ghim sau lần Kiểm tra kết nối; nếu key đổi thì dừng lại.
- Trang quản trị chạy HTTPS (chứng chỉ tự ký, hoặc Let's Encrypt khi đặt tên miền cho trang quản trị), có xác thực 2 lớp, giới hạn IP, chống dò mật khẩu, thu hồi phiên đăng nhập; token SSE được che trong log. Hướng dẫn: docs/vi/security.md.
Giới hạn hiện tại
- Chuyển database chỉ hỗ trợ MySQL/MariaDB; site Next.js dùng DB ngoài (Postgres, Mongo...) cần tự chuyển DB đó.
- Biến môi trường bí mật của Next.js không nằm trong mã nguồn (ví dụ trong process manager của panel cũ) cần được nhập lại.
- Bản sao lưu hiện chỉ lưu trên chính VPS; hãy tự chép ra ngoài.
Giấy phép
Lares Panel là phần mềm tự do theo GNU Affero General Public License v3.0 (AGPL-3.0). © ThoCode.
