Cách cài đặt Pydio Cells trên Ubuntu 24.04 Server

[theanh]

Pydio Cells là nền tảng chia sẻ và cộng tác tài liệu tự lưu trữ. Nền tảng này cũng cung cấp cho bạn toàn quyền kiểm soát môi trường chia sẻ tài liệu của mình. Pydio Cells có hiệu suất nhanh, xử lý các kích thước truyền tệp lớn và cung cấp khả năng tự động hóa quy trình làm việc tiên tiến.

Trong hướng dẫn này, chúng tôi sẽ hướng dẫn bạn cài đặt Pydio Cells trên máy chủ Ubuntu 24.04 với cơ sở dữ liệu MariaDB và Apache làm proxy ngược.

Điều kiện tiên quyết​

Trước khi bắt đầu, hãy đảm bảo rằng bạn có những điều sau:

• Máy chủ Ubuntu 24.04.
• Người dùng không phải root có quyền quản trị viên.
• Tên miền được trỏ đến địa chỉ IP của máy chủ.

Cài đặt các phần phụ thuộc​

Trước khi cài đặt Pydio Cells, bạn phải cài đặt các phần phụ thuộc trên hệ thống Ubuntu của mình. Điều này bao gồm máy chủ cơ sở dữ liệu MariaDB và máy chủ web Apache.

Đầu tiên, hãy chạy lệnh apt sau để cập nhật chỉ mục gói Ubuntu của bạn và cài đặt các phụ thuộc cho Pydio Cells. Với lệnh này, bạn sẽ cài đặt máy chủ web Apache, máy chủ cơ sở dữ liệu MariaDB và Certbot để tạo chứng chỉ SSL/TLS.

sudo apt update sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget

Đầu vào Y để xác nhận cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22354%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, hãy kiểm tra trạng thái dịch vụ Apache bằng lệnh sau:

sudo systemctl is-enabled apache2 sudo
systemctl status apache2

Bạn có thể thấy bên dưới máy chủ web Apache được bật và đang chạy.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22250%22%3E%3C/svg%3E


Bây giờ hãy kiểm tra trạng thái máy chủ MariaDB bằng lệnh bên dưới.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Bên dưới máy chủ MariaDB đang chạy và được bật.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22258%22%3E%3C/svg%3E

Thiết lập máy chủ MariaDB​

Sau khi cài đặt máy chủ MariaDB, bạn sẽ bảo mật MariaDB bằng tiện ích mariadb-secure-installation. Sau đó, bạn sẽ tạo một cơ sở dữ liệu và người dùng mới cho Pydio Cells.

Để bảo mật cài đặt máy chủ MariaDB, hãy chạy lệnh mariadb-secure-installation bên dưới.

sudo mariadb-secure-installation

Bạn sẽ được hỏi về cấu hình máy chủ MariaDB bên dưới:

• Chuyển xác thực cục bộ sang unix_socket? Nhập n.
• Thiết lập mật khẩu gốc MariaDB mới. Nhập y để xác nhận, sau đó nhập mật khẩu mới cho triển khai máy chủ MariaDB của bạn.
• Xóa người dùng ẩn danh? Nhập y để xác nhận.
• Xóa kiểm tra cơ sở dữ liệu mặc định khỏi triển khai?. Nhập y để xác nhận.
• Không cho phép đăng nhập gốc MariaDB từ các kết nối từ xa? Nhập y để xác nhận.
• Tải lại các đặc quyền của bảng và áp dụng các thay đổi? Nhập y và nhấn ENTER.

Bây giờ hãy chạy lệnh máy khách mariadb bên dưới để đăng nhập vào máy chủ MariaDB. Nhập mật khẩu gốc của bạn khi được nhắc.

sudo mariadb -u root -p

Tiếp theo, chạy các truy vấn sau để tạo cơ sở dữ liệu mới cellsdb, người dùng cells và mật khẩu . Hãy đảm bảo thay đổi các chi tiết bên dưới bằng thông tin của bạn.

CREATE DATABASE cellsdb;
CREATE USER cells@localhost IDENTIFIED BY 'cellsp4ssword';
GRANT ALL PRIVILEGES ON cellsdb.* TO cells@localhost;
FLUSH PRIVILEGES;


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22260%22%3E%3C/svg%3E


Bây giờ hãy chạy truy vấn bên dưới để đảm bảo rằng người dùng cells@localhost có thể truy cập cơ sở dữ liệu cellsdb.

SHOW GRANTS FOR cells@localhost;

Bạn sẽ thấy đầu ra tương tự bên dưới:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22269%22%3E%3C/svg%3E


Nhập quit để thoát khỏi máy chủ MariaDB.

Cài đặt Pydio Cells​

Trong phần này, bạn sẽ tạo một pydio người dùng, thiết lập các biến môi trường, sau đó tải xuống và cài đặt Pydio Cells.

Thêm người dùng mới pydio bằng lệnh sau:

sudo useradd -m -s /bin/bash pydio

Sau đó, chạy lệnh bên dưới để tạo một thư mục mới /opt/pydio/bin và /var/cells và thay đổi quyền sở hữu thành pydio user.

sudo mkdir -p /opt/pydio/bin /var/cells
sudo chown -R pydio: /opt/pydio/bin /var/cells

Bây giờ hãy chạy lệnh sau để tạo tệp env /etc/profile.d/cells-env.sh và biến nó thành tệp thực thi. Tệp này sẽ được thực thi khi người dùng đăng nhập.

sudo tee -a /etc/profile.d/cells-env.sh << EOF
export CELLS_WORKING_DIR=/var/cells
export CELLS_BIND=127.0.0.1:8080
export CELLS_EXTERNAL=https://cells.howtoforge.local
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh

Tiếp theo, đăng nhập với tư cách là người dùng pydio và kiểm tra các biến môi trường $CELLS_WORKING_DIR, $CELLS_BIND và . Đảm bảo mỗi lệnh trỏ đến giá trị chính xác như trong tệp /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR
echo $CELLS_BIND
echo $CELLS_EXTERNAL


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22515%22%20height=%22248%22%3E%3C/svg%3E


Bây giờ hãy chạy lệnh bên dưới để tải tệp nhị phân Pydio xuống /opt/pydio/bin/cells.

export distribId=cells
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/

Làm cho tệp /opt/pydio/bin/cells có thể thực thi và thoát khỏi người dùng pydio hiện tại.

chmod a+x /opt/pydio/bin/cells exit

Sau đó, chạy setcap lệnh bên dưới để cho phép Pydio sử dụng các cổng đặc quyền (0-1024) và tạo liên kết tượng trưng đến /usr/local/bin/cells.

sudo setcap 'cap_net_bind_service=+ep' /opt/pydio/bin/cells
sudo ln -s /opt/pydio/bin/cells /usr/local/bin/cells

Đăng nhập với tư cách là người dùng pydio một lần nữa và chạy lệnh cells bên dưới để kiểm tra phiên bản Pydio Cells.

su - pydio
phiên bản cell

Như bạn có thể thấy bên dưới, Pydio Cells 4.4.3 đã được cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22598%22%20height=%22250%22%3E%3C/svg%3E

Cấu hình Pydio Cells​

Bây giờ bạn đã tải xuống Pydio Cells, bạn sẽ cấu hình và tích hợp nó với máy chủ cơ sở dữ liệu MariaDB và tạo một người dùng quản trị để cài đặt Pydio Cells. Những thao tác này có thể được thực hiện thông qua dòng lệnh cells.

Chạy lệnh cells bên dưới để cài đặt và cấu hình cài đặt Pydio Cells.

cells configure --cli

• Chọn TCP cho kết nối cơ sở dữ liệu và nhập MariaDB của bạn cơ sở dữ liệu, người dùng và mật khẩu.
• Nhập N để được hỗ trợ MongoDB. Trong trường hợp này, bạn sẽ xây dựng và cài đặt các Pydio Cells đơn lẻ.
• Nhấn ENTER để sử dụng cấu hình lưu trữ mặc định.
• Nhập tên người dùng quản trị mới, địa chỉ email và mật khẩu để cài đặt Pydio Cells.

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22425%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, bạn sẽ thấy thông báo Installation finished.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22655%22%20height=%22234%22%3E%3C/svg%3E

Chạy Pydio Cells dưới dạng dịch vụ systemd​

Trong phần này, bạn sẽ tạo và thiết lập tệp dịch vụ systemd cho Pydio Cells. Với điều này, bạn có thể dễ dàng quản lý Pydio Cells bằng lệnh systemctl.

Tạo tệp dịch vụ mới /etc/systemd/system/cells.service với Trình soạn thảo nano.

sudo nano /etc/systemd/system/cells.service

Thêm cấu hình sau vào tệp và đảm bảo thay đổi biến môi trường CELLS_EXTERNAL bằng tên miền mục tiêu của bạn.

[Unit]
Description=Pydio Cells
Documentation=https://pydio.com
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/opt/pydio/bin/cells
[Service]
User=pydio
Group=pydio
PermissionsStartOnly=true
AmbientCapabilities=CAP_NET_BIND_SERVICE
ExecStart=/opt/pydio/bin/cells start
Restart=on-failure
StandardOutput=journal
StandardError=inherit
LimitNOFILE=65536
TimeoutStopSec=5
KillSignal=INT
SendSIGKILL=yes
SuccessExitStatus=0
WorkingDirectory=/home/pydio
# Add environment variables
Environment=CELLS_WORKING_DIR=/var/cells
Environment=CELLS_BIND=127.0.0.1:8080
Environment=CELLS_EXTERNAL=https://cells.howtoforge.local
[Install]
WantedBy=multi-user.target

Lưu tệp và thoát khỏi trình chỉnh sửa.

Bây giờ hãy chạy lệnh systemctl bên dưới để tải lại trình quản lý systemd và áp dụng các thay đổi của bạn.

sudo systemctl daemon-reload

Khởi động và bật cells bằng lệnh bên dưới. Sau đó, hãy kiểm tra trạng thái cells để đảm bảo rằng dịch vụ đang chạy.

sudo systemctl enable --now cells
sudo systemctl status cells


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22298%22%3E%3C/svg%3E

Thiết lập Apache làm proxy ngược​

Sau khi Pydio Cells chạy như một dịch vụ systemd, bạn sẽ tạo một tệp máy chủ ảo Apache mới làm proxy ngược cho Pydio Cells. Bạn cũng cần phải kích hoạt các mô-đun Apache bằng lệnh a2enmod.

Trước tiên, hãy chạy lệnh a2enmod bên dưới để kích hoạt các mô-đun Apache. Trong trường hợp này, bạn sẽ kích hoạt các mô-đun cho SSL và proxy ngược.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22363%22%3E%3C/svg%3E


Bây giờ hãy tạo một tệp máy chủ ảo mới /etc/apache2/sites-available/cells.conf bằng lệnh nano sau.

sudo nano /etc/apache2/sites-available/cells.conf

Chèn cấu hình bên dưới để thiết lập Apache làm proxy ngược cho Pydio Cells. Đảm bảo thay đổi tùy chọn ServerName bằng tên miền mục tiêu của bạn.

 ServerName cells.howtoforge.local AllowEncodedSlashes On RewriteEngine On # be aware of this # Allow reverse proxy via self-signed certificates SSLProxyEngine On SSLProxyVerify none SSLProxyCheckPeerCN off SSLProxyCheckPeerName off SSLProxyCheckPeerExpire off ## The order of the directives matters. # If Cells is not running with https, consider using ws instead of wss ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon ## This rewrite condition is required if using Cells-Sync # RewriteCond %{HTTP:Content-Type} =application/grpc [NC] # RewriteRule /(.*) h2://localhost:8080/$1 [P,L] ProxyPass "/" "https://127.0.0.1:8080/" ProxyPassReverse "/" "https://127.0.0.1:8080/" ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined

Lưu và thoát tệp khi hoàn tất.

Tiếp theo, chạy Lệnh a2ensite bên dưới để kích hoạt máy chủ ảo cells.conf và xác minh cấu hình Apache của bạn. Nếu bạn cấu hình Apache đúng, bạn sẽ thấy đầu ra Syntax is OK.

sudo a2ensite cells.conf
sudo apachectl configtest

Cuối cùng, hãy chạy lệnh systemctl bên dưới để khởi động lại máy chủ web Apache và áp dụng changes.

sudo systemctl restart apache2


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22723%22%20height=%22274%22%3E%3C/svg%3E

Bảo mật Pydio Cells bằng HTTPS​

Pydio Cells có thể truy cập qua HTTPS. Vì vậy, bạn phải bật HTTPS trên tệp máy chủ ảo Apache của mình. Trong phần này, bạn sẽ tạo chứng chỉ SSL/TLS bằng certbot để bảo mật cài đặt Pydio Cells.

Để bảo mật Pydio Cells bằng HTTPS, hãy chạy lệnh certbot bên dưới. đảm bảo thay đổi tên miền và địa chỉ email bên dưới bằng thông tin của bạn.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [emailprotected] -d cells.howtoforge.local

Sau khi quá trình hoàn tất, chứng chỉ SSL/TLS của bạn sẽ có trong thư mục /etc/letsencrypt/live/domain.com.

Bây giờ hãy mở trình duyệt web của bạn và truy cập tên miền của bạn https://cells.howtoforge.local/. Nếu cài đặt thành công, bạn sẽ được nhắc đến trang đăng nhập Pydio Cells.

Nhập tên người dùng và mật khẩu quản trị viên của bạn, rồi nhấp vào ENTER.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22619%22%20height=%22545%22%3E%3C/svg%3E


Bạn sẽ thấy bảng điều khiển Pydio Cells như sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22414%22%3E%3C/svg%3E

Kết luận​

Xin chúc mừng! Bạn đã hoàn tất cài đặt Pydio Cells trên máy chủ Ubuntu 24.04. Bạn đã chạy Pydio Cells với máy chủ cơ sở dữ liệu MariaDB và Apache làm proxy ngược. Cuối cùng, bạn cũng đã bảo mật Pydio Cells bằng HTTPS thông qua Certbot và Letsencrypt.