Quay lại danh sách
DevOps & Hệ thống

Tự Host Penpot trên VPS ARM64: Hướng dẫn vượt qua lỗi tương thích kiến trúc để chạy nền tảng thiết kế UI/UX riêng

Đây là hướng dẫn chi tiết để tự triển khai Penpot – nền tảng thiết kế UI/UX mã nguồn mở – trên VPS ARM64, vượt qua các lỗi tương thích kiến trúc phần cứng và phần mềm. Hướng dẫn này...

DPTCloud Engineering6 phút đọc
Tự Host Penpot trên VPS ARM64: Hướng dẫn vượt qua lỗi tương thích kiến trúc để chạy nền tảng thiết kế UI/UX riêng

Đây là hướng dẫn chi tiết để tự triển khai Penpot – nền tảng thiết kế UI/UX mã nguồn mở – trên VPS ARM64, vượt qua các lỗi tương thích kiến trúc phần cứng và phần mềm. Hướng dẫn này bao gồm cấu hình Docker, thiết lập biến môi trường, xử lý lỗi nhị phân không tương thích, và tối ưu hóa hiệu năng cho môi trường sản xuất. Penpot cung cấp một thay thế tự chủ cho các công cụ thiết kế đám mây, cho phép doanh nghiệp kiểm soát toàn bộ dữ liệu thiết kế và tùy chỉnh giao diện người dùng.

Giới thiệu về Penpot và lợi ích tự host

Penpot là nền tảng thiết kế UI/UX mã nguồn mở, tương thích với Figma, cho phép người dùng tạo, chỉnh sửa và chia sẻ thiết kế trực quan mà không cần kết nối đến đám mây. Tự host Penpot trên VPS ARM64 mang lại lợi ích lớn về kiểm soát dữ liệu, bảo mật nội bộ, chi phí vận hành thấp và khả năng tùy chỉnh cao. Tuy nhiên, do Penpot chủ yếu được xây dựng cho kiến trúc x86_64, việc triển khai trên máy chủ ARM64 (như Apple Silicon hoặc các VPS ARM64) thường gặp lỗi liên quan đến nhị phân không tương thích.

Việc vượt qua các lỗi tương thích kiến trúc là bước then chốt để Penpot chạy ổn định trên nền tảng ARM64. Hướng dẫn này cung cấp giải pháp thực tế bằng cách sử dụng Docker, thiết lập môi trường phù hợp và cấu hình lại các thành phần phụ thuộc để đảm bảo Penpot hoạt động trơn tru trên VPS ARM64.

Yêu cầu và cấu hình ban đầu

Để triển khai Penpot trên VPS ARM64, bạn cần một máy chủ có kiến trúc ARM64 (ví dụ: Raspberry Pi 4, máy chủ ARM64 hoặc VPS như được cung cấp tại Cloud VPS NVMe cho Docker, Nginx & Database). Các yêu cầu cơ bản bao gồm:

  • OS: Ubuntu 22.04 hoặc Debian 11 (ARM64)
  • Docker và Docker Compose đã cài đặt
  • Phần mềm cần thiết: curl, git, và một trình quản lý cổng như Nginx hoặc Caddy
  • Phần cứng: tối thiểu 4GB RAM, 2 vCPU, 20GB SSD

Chuẩn bị hệ thống bằng cách cập nhật gói và cài đặt Docker:

sudo apt update
sudo apt install -y curl git
curl -sSL https://get.docker.com | sh
sudo usermod -aG docker $USER
sudo systemctl enable docker

Sau khi đăng nhập lại, kiểm tra Docker hoạt động:

docker --version
docker compose version

Triển khai Penpot với Docker trên ARM64

Penpot sử dụng Docker Compose để quản lý các dịch vụ như Web, API, Redis, PostgreSQL và File Storage. Tuy nhiên, các hình ảnh mặc định có thể không hỗ trợ ARM64. Để giải quyết, cần sử dụng các hình ảnh được xây dựng lại cho ARM64 hoặc xây dựng từ mã nguồn.

Đầu tiên, tạo thư mục làm việc và sao chép file `docker-compose.yml` từ kho Penpot chính thức. Tuy nhiên, do các hình ảnh gốc không tương thích, bạn cần thay thế chúng bằng các hình ảnh thay thế được xây dựng cho ARM64.

Thay thế các dòng hình ảnh trong `docker-compose.yml` bằng các hình ảnh tương thích ARM64:

services:
  web:
    image: penpot/penpot-web:latest-arm64
    # ... các cấu hình khác
  api:
    image: penpot/penpot-api:latest-arm64
    # ... các cấu hình khác

Thay vì sử dụng hình ảnh `latest`, nên dùng phiên bản cụ thể hoặc xây dựng hình ảnh từ mã nguồn. Bạn có thể tạo một Dockerfile tùy chỉnh để xây dựng lại các thành phần cho ARM64:

FROM penpot/penpot-web:latest
# Các bước tùy chỉnh cho ARM64

Chạy lệnh khởi động:

docker compose up -d

Penpot sẽ bắt đầu khởi động, nhưng cần kiểm tra log để xác định lỗi liên quan đến kiến trúc.

Xử lý lỗi tương thích kiến trúc

Trong quá trình triển khai, bạn có thể gặp lỗi như `exec format error` hoặc `no such file or directory`, cho thấy nhị phân không tương thích với kiến trúc ARM64. Các lỗi này thường xảy ra với các thành phần như Node.js, PostgreSQL hoặc Redis.

Để khắc phục:

  1. Thay thế các hình ảnh mặc định bằng các hình ảnh được xây dựng cho ARM64. Tìm kiếm trên Docker Hub các hình ảnh có tiền tố `arm64v8` hoặc `linux/arm64`.
  2. Sử dụng `docker buildx` để xây dựng hình ảnh từ mã nguồn trên kiến trúc ARM64:
docker buildx build --platform linux/arm64 -t penpot-web-arm64 .

Đảm bảo rằng tất cả các thành phần phụ thuộc đều được xây dựng hoặc sử dụng hình ảnh tương thích. Các dịch vụ như Redis và PostgreSQL có thể cần cấu hình riêng để chạy trên ARM64.

Xác minh và tối ưu hóa

Sau khi Penpot chạy, truy cập vào địa chỉ IP hoặc tên miền của VPS để kiểm tra giao diện người dùng. Các bước xác minh bao gồm:

  • Truy cập http://your-vps-ip:3000 và đăng nhập bằng tài khoản mặc định.
  • Thực hiện tạo một thiết kế mới để kiểm tra chức năng.
  • Chạy lệnh docker compose ps để kiểm tra trạng thái các dịch vụ.

Để tối ưu hóa hiệu năng, bạn có thể:

  • Thêm cấu hình Nginx để làm reverse proxy và hỗ trợ HTTPS.
  • Thiết lập Redis làm bộ nhớ đệm cho các yêu cầu API.
  • Chạy các dịch vụ như PostgreSQL trên một VPS riêng biệt để phân tách tải.

Penpot cũng hỗ trợ tích hợp với các công cụ như Git và CI/CD, cho phép quản lý thiết kế như mã nguồn.

Giải pháp thay thế và lời khuyên

Nếu việc xây dựng hình ảnh ARM64 quá phức tạp, bạn có thể sử dụng các giải pháp thay thế như:

Việc tự host Penpot trên ARM64 đòi hỏi kỹ năng DevOps cơ bản, nhưng mang lại lợi ích về kiểm soát và tùy chỉnh cao. Với các bước cấu hình đúng, Penpot có thể hoạt động ổn định như một nền tảng thiết kế UI/UX độc lập.

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478