Wholly Crypto với Docker.

Trước khi bắt đầu.

Dùng một VPS Linux amd64 / x86-64 mới có quyền root, Bash và curl. Trình thiết lập đề nghị cài Python 3.9+, Git, Docker Engine, Docker Compose và Buildx còn thiếu sau khi bạn xác nhận.

Bắt đầu với 2 vCPU, 4 GB RAM và 30 GB SSD cho nhu cầu nhẹ. Chừa dung lượng cho lịch sử, image và bản sao lưu.

Tự động thiết lập phần mềm tiên quyết: Ubuntu 22.04/24.04/26.04, Debian 12/13, Fedora 43/44/45 và RHEL 9/10. Với bản phân phối khác, hãy cài phần mềm tiên quyết trước.

Giữ các cổng 80 và 443 trống và mở trên cả hai tường lửa. Trỏ bản ghi DNS của bảng điều khiển nhà bán hàng, trang thanh toán và API về VPS. Với Cloudflare, dùng chế độ chỉ DNS khi thiết lập; bật proxy sau khi hoàn tất xác thực HTTPS.

Chọn Docker hoặc bộ cài đặt gốc. Thiết lập Docker không di chuyển bản cài đặt hiện có hay dừng máy chủ web khác.

Cài đặt bằng một lệnh.

bash <(curl -fsSL https://raw.githubusercontent.com/whollycrypto-com/whollycrypto-docker/v1.1.1/install.sh)

Chọn tên miền, IP công khai của VPS, email gia hạn, tiền pháp định và tài khoản Basic Auth. Giá trị mặc định là merchant.example.com, pay.example.com và api.example.com. Bạn có thể chọn tên miền con khác.

Trình thiết lập dựng image chạy ứng dụng, xác minh bản tải nhà bán hàng đã ký, khởi động PostgreSQL 18 và cấp chứng chỉ HTTPS. GitHub là nguồn tải dự phòng. Không cần mã nguồn nhà bán hàng, trình biên dịch Rust hay nút blockchain.

Các engine, container và volume hiện có được giữ nguyên. Trình thiết lập dừng để bạn kiểm tra thủ công nếu phát hiện gói xung đột.

Chờ dòng Ready: https://… trong nhật ký. Mở địa chỉ đó, nhập tài khoản Basic Auth và tạo tài khoản quản trị viên. Nếu thiết lập dừng, khắc phục vấn đề được báo rồi chạy ./whollycrypto-docker resume. Khóa ví hiện có được giữ nguyên.

Kho mã và hướng dẫn thiết lập đầy đủ ↗

Quản lý bản cài đặt.

Chạy các lệnh này từ /root/whollycrypto-docker. Bảng điều khiển, trang thanh toán, API và quy tắc tín dụng xử lý hoạt động như trong bản cài đặt gốc.

Cài đặt → Hệ thống cũng có thể cài bản cập nhật nhà bán hàng. Dựng lại image Docker không thay phần mềm nhà bán hàng đã cài hay bỏ qua kiểm tra cập nhật. Cập nhật riêng các phụ thuộc của container theo hướng dẫn cập nhật môi trường chạy trong kho mã.

Giữ một bản sao bên ngoài VPS.

./whollycrypto-docker backup

Bản sao lưu đầy đủ này tạm dừng trang thanh toán trong chốc lát. Nó lưu và xác minh cơ sở dữ liệu, tệp nhà bán hàng, khóa mã hóa ví, Nginx, chứng chỉ và các bí mật thiết lập tương ứng. Sao chép toàn bộ thư mục sao lưu có dấu thời gian vào nơi lưu trữ ngoại tuyến an toàn.

Bản sao lưu chứa khóa riêng và thông tin xác thực chưa mã hóa. Không bao giờ đưa chúng vào Git hoặc thư mục công khai. Đồng thời xuất bản sao lưu ví dự án từ bảng điều khiển. Ví Lightning đã kết nối cần quy trình khôi phục riêng.

Không bao giờ dùng docker compose down -v để sửa lỗi. Lệnh này xóa volume lưu trữ bền vững và có thể phá hủy khóa ví cùng lịch sử thanh toán. Dùng ./whollycrypto-docker stop để dừng mà không xóa dữ liệu. Làm theo hướng dẫn khôi phục trước khi khôi phục.

Hệ thống gọn nhẹ. Dữ liệu riêng biệt.

Hai container: nhà bán hàng cùng Nginx, và PostgreSQL. Dữ liệu được giữ khi thay container nhờ volume có tên. Cơ sở dữ liệu dùng Unix socket riêng; các cổng 5432 và 8080 không được công bố. Không cần chế độ đặc quyền, mạng máy chủ hay Docker socket của máy chủ.

Docker dùng cơ chế cô lập container, không phải sandbox systemd của trình cài đặt gốc. Root và quản trị viên Docker vẫn có thể truy cập khóa của bạn. Luôn bật Basic Auth và các giới hạn IP phù hợp cho tên miền/API. Công bố cổng Docker có thể vượt qua quy tắc UFW; kiểm tra tường lửa nhà cung cấp và hướng dẫn tường lửa Docker.

Thiết lập Docker ban đầu dành cho Linux amd64 với Nginx riêng. ARM64, Docker Desktop, Docker không root và reverse proxy bổ sung hiện chưa phải cấu hình được hỗ trợ.