Tài liệu

Bắt đầu nhanh + mô tả chức năng của từng phần, từng thiết bị (đang tiếp tục cập nhật)

Kho ứng dụng

Bài viết này giới thiệu「Kho ứng dụng」của bảng điều khiển — hướng dẫn đầy đủ về triển khai các ứng dụng thông dụng bằng một cú nhấp.

Hiểu trong một câu

Kho ứng dụng là「cửa hàng ứng dụng」tích hợp sẵn, tập hợp nhiều ứng dụng mã nguồn mở thông dụng (blog, ổ đĩa mạng, ghi chú, giám sát, cơ sở dữ liệu...). Nhấp một cái là tự động hoàn tất triển khai Docker trên máy chủ đích, không cần tự viết docker-compose hay tra cứu hướng dẫn.

Giới thiệu chức năng

Kho ứng dụng tập hợp các ứng dụng mã nguồn mở thông dụng, mỗi ứng dụng đều có sẵn「tài khoản/mật khẩu mặc định + cổng + thư mục dữ liệu + các bước triển khai + lưu ý」; bạn chỉ cần nhấp「Cài đặt」, chọn máy chủ, điền vài tham số quan trọng, phần còn lại (kéo image, tạo cơ sở dữ liệu, cấu hình biến môi trường, khởi động vùng chứa) đều tự động hoàn tất.

Tình huống áp dụng

  • Muốn triển khai nhanh một ứng dụng (như ổ đĩa mạng Nextcloud, blog WordPress, ghi chú Memos)
  • Không muốn tự nghiên cứu biến môi trường, ánh xạ cổng, lưu trữ bền dữ liệu
  • Mong mỗi ứng dụng đều có sẵn「tài khoản/mật khẩu mặc định + các bước triển khai + lưu ý」

Cách sử dụng

1. Vào「Kho ứng dụng」, duyệt hoặc tìm kiếm ứng dụng

2. Chuyển sang「Tất cả」hoặc「Đã cài đặt」để xem

3. Nhấp vào một ứng dụng để xem chi tiết (tài khoản/mật khẩu mặc định, cổng, thư mục dữ liệu, lưu ý)

4. Nhấp「Cài đặt」, chọn máy chủ đích, điền cấu hình theo hướng dẫn (mật khẩu, cổng...)

Cài đặt CMS (hệ quản trị nội dung) bằng một cú nhấp

Kho ứng dụng có sẵn danh mục「Hệ quản trị nội dung (cài đặt CMS một cú nhấp)」, gồm WordPress, Joomla, Drupal, MediaWiki, Halo, Ghost và các CMS phổ biến khác, tất cả đều hỗ trợ cài đặt một cú nhấp + tự động cấu hình cơ sở dữ liệu, suốt quá trình không cần viết SQL thủ công:

1. Tự động kiểm tra/cài đặt Docker

2. Tự động khởi động vùng chứa cơ sở dữ liệu MariaDB dùng chung (sshe-mysql, chỉ cần một lần, các CMS về sau tái sử dụng)

3. Tự động tạo cơ sở dữ liệu và người dùng riêng cho mỗi trang web (mật khẩu mạnh ngẫu nhiên, mật khẩu root được lưu bền vào /opt/sshe-mysql/.root_password trên máy chủ để tái sử dụng)

4. Tự động khởi động vùng chứa CMS và chèn cấu hình cơ sở dữ liệu

5. Sau khi cài xong, cửa sổ hiện địa chỉ truy cập + thông tin đăng nhập cơ sở dữ liệu, có thể sao chép bằng một cú nhấp

Ba dạng:

  • Hoàn toàn tự động (WordPress / Joomla): image chính thức hỗ trợ biến môi trường cơ sở dữ liệu, cài xong dùng được ngay
  • Trình hướng dẫn web (Drupal / MediaWiki): công cụ tự tạo cơ sở dữ liệu và người dùng, bạn điền thông tin đăng nhập tự sinh vào trình hướng dẫn cài đặt trên web (không cần gõ SQL)
  • Cơ sở dữ liệu tích hợp (Halo / Ghost): không cần cơ sở dữ liệu bên ngoài, một cú nhấp chạy trực tiếp

> Gợi ý: nếu máy chủ trong Trung Quốc đại lục bị timeout khi kéo image từ Docker Hub, hãy cấu hình Docker mirror accelerator trên máy chủ trước (accelerator công cộng như docker.1ms.run / docker.m.daocloud.io).

Xem / sao lưu thông tin đăng nhập cơ sở dữ liệu của một trang web

Sau khi cài đặt một cú nhấp, thông tin đăng nhập cơ sở dữ liệu của mỗi trang web sẽ tự động được lưu vào máy chủ đích: /opt/sshe-db-creds/<tên-vùng-chứa>.conf (gồm DB_HOST / DB_NAME / DB_USER / DB_PASS / DB_ROOT, quyền 600).

Trong phần chi tiết CMS của Kho ứng dụng hoặc Kho image, nhấp「Xem thông tin đăng nhập cơ sở dữ liệu」là xem được bất cứ lúc nào, cửa sổ tự động kèm theo:

  • 🚀 Triển khai phpMyAdmin bằng một cú nhấp: nhấp một cái là tự động triển khai phpMyAdmin trong mạng sshe-cms-net (tự chọn cổng trống, mặc định 8888, trỏ tới sshe-mysql), kèm nút「Mở phpMyAdmin (đã tự điền đăng nhập)」, vào thẳng cơ sở dữ liệu, duyệt / nhập xuất / truy vấn trực quan cực dễ.
  • Lệnh sao lưu: docker exec sshe-mysql mariadb-dump -uroot -p'<DB_ROOT>' <DB_NAME> > /opt/sshe-db-creds/<DB_NAME>.bak.sql
  • Đăng nhập phpMyAdmin dự phòng: máy chủ điền sshe-mysql, người dùng/mật khẩu dùng người dùng/mật khẩu cơ sở dữ liệu ở trên.

> Lưu ý: tệp thông tin đăng nhập chỉ được sinh ra khi CMS được triển khai qua「cài đặt một cú nhấp」; nếu bạn triển khai thủ công bằng docker run, hãy tự xem cấu hình ứng dụng (như wp-config.php của WordPress).

Chi tiết mỗi ứng dụng gồm những gì

Thông tinMô tả
Tài khoản / mật khẩu mặc địnhTài khoản khởi tạo của ứng dụng (như admin của Nextcloud)
Cổng mặc địnhCổng ứng dụng lắng nghe
Thư mục dữ liệuVị trí lưu trữ bền dữ liệu
Các bước triển khaiCác bước đầy đủ cho ứng dụng phụ thuộc cơ sở dữ liệu (cài cơ sở dữ liệu → tạo cơ sở dữ liệu và người dùng → cấu hình biến môi trường → khởi tạo)
Lưu ýXung đột cổng, mức chiếm tài nguyên, cảnh báo bảo mật...

Quản lý ứng dụng đã cài đặt

Chuyển sang「Đã cài đặt」, mỗi ứng dụng đã cài cung cấp thao tác nội tuyến: Cài đặt / Gỡ cài đặt / Dừng / Khởi động / Khởi động lại / Xóa, tiện cho vận hành hàng ngày.

Ứng dụng phụ thuộc cơ sở dữ liệu

Một số ứng dụng (như Nextcloud, WordPress) phụ thuộc MySQL/PostgreSQL. Các bước triển khai loại ứng dụng này sẽ tự động bao gồm:

1. Triển khai cơ sở dữ liệu trước (MySQL/MariaDB/PostgreSQL)

2. Tạo cơ sở dữ liệu và người dùng

3. Cấu hình biến môi trường của ứng dụng (địa chỉ cơ sở dữ liệu, tài khoản, mật khẩu)

4. Khởi tạo ứng dụng

Bảng điều khiển sẽ nối các bước này lại với nhau, bạn chỉ cần điền những thông tin quan trọng như mật khẩu theo hướng dẫn.

Hỗ trợ nhiều bản phân phối

Lệnh cài đặt của Kho ứng dụng tự động thích ứng với trình quản lý gói của máy chủ đích, không cần chọn thủ công:

Bản phân phốiTrình quản lý góiCách tương thích
Debian / UbuntuaptLệnh gốc
Fedora / Rocky / CentOS / RHELdnf / yumTự động ánh xạ (apt-get → dnf/yum)
AlpineapkTự động ánh xạ

Đồng thời tự động xử lý khác biệt tên gói thường gặp (như apache2 → httpd, apache2-utils → httpd-tools) và khác biệt tên dịch vụ (apache2.service → httpd.service).

> ⚠️ Chú ý: một số ứng dụng phụ thuộc cách cài đặt riêng của bản phân phối (như ufw chỉ dành cho Ubuntu, nguồn deb.nodesource của Node.js chỉ có trên Debian/Ubuntu), trên Fedora/Rocky có thể không cài được. Khi cài đặt thất bại, bảng điều khiển sẽ hiển thị thông báo lỗi trung thực.

Lưu ý

1. Triển khai ứng dụng cần máy chủ đích đã cài Docker.

2. Placeholder mật khẩu sẽ được ghi rõ (như「<mật-khẩu-cơ-sở-dữ-liệu-của-bạn>」), hãy thay bằng mật khẩu mạnh của bạn.

3. Ứng dụng mặc định liên kết trên cổng của máy chủ đích; nếu máy chủ đó không có IP công cộng (máy chủ NAT/xuyên NAT), cần kết hợp Xuyên cổng hoặc Chuyển tiếp cổng mới truy cập được từ bên ngoài.

4. Bản phân phối quá cũ (như Fedora 32 và các phiên bản đã EOL) có nguồn phần mềm ngừng bảo trì, cài đặt có thể timeout hoặc thất bại, nên nâng cấp lên phiên bản được hỗ trợ.