Sau khi nâng cấp DSM 7 Nextcloud không chạy là tình trạng khá phổ biến — nguyên nhân chính là DSM 7.x bỏ hỗ trợ PHP 7.x, khiến các bản Nextcloud cũ cài theo kiểu native không thể khởi động. Giải pháp gọn nhất là chuyển Nextcloud sang chạy trong Docker, giữ nguyên toàn bộ database và dữ liệu cũ, không cần nâng cấp phiên bản Nextcloud.
Bài viết hướng dẫn cụ thể từng bước cho trường hợp migrate Nextcloud 19.x sang Docker trên DSM 7.x, áp dụng được cho các phiên bản Nextcloud cũ khác có cùng vấn đề.
Tại Sao Nâng Cấp DSM 7 Khiến Nextcloud Không Chạy?
DSM 6.2 đi kèm PHP 7.x. Khi nâng lên DSM 7.x, Synology loại bỏ PHP 7.x khỏi Web Station — các ứng dụng web cài native phụ thuộc vào PHP này sẽ báo lỗi hoặc không load được. Nextcloud 19 trở về trước là những phiên bản bị ảnh hưởng trực tiếp.
Thay vì nâng cấp Nextcloud từng bước (19 → 20 → 21 → … → mới nhất, rất tốn thời gian), cách nhanh hơn là đóng gói Nextcloud cũ vào Docker container với PHP phiên bản tương thích, cho chạy độc lập với PHP của DSM.
Mục Tiêu
- Chạy lại Nextcloud phiên bản cũ bằng Docker, không phụ thuộc PHP của DSM
- Giữ nguyên database và toàn bộ dữ liệu cũ
- Chạy ổn định trên DSM 7.x mà không cần nâng cấp Nextcloud
Bước 1: Chuẩn Bị Thư Mục Và Dump Database
Tạo cấu trúc thư mục để Docker mount vào:
|
1 2 3 4 |
/volume1/docker/nextcloud/app ← mã nguồn Nextcloud cũ /volume1/docker/nextcloud/db ← dữ liệu MariaDB /volume1/nextcloud/data ← thư mục data cũ của Nextcloud |
Copy toàn bộ mã nguồn Nextcloud cũ vào /volume1/docker/nextcloud/app.
Dump Database Trước Khi Tiến Hành
Nextcloud cũ đang dùng MariaDB 10.x cài native trên DSM. Cần dump trước khi làm bất cứ thứ gì. Nếu đã nâng DSM rồi mà chưa dump, vào Package Manager repair lại MariaDB — DSM 7.0 vẫn chạy được.
SSH vào Synology, chạy lệnh dump:
|
1 2 3 |
cd /volume1/docker/nextcloud mysqldump -h127.0.0.1 -P3307 -u root -p nextcloud > nextcloud.sql |
Bước 2: Tạo File docker-compose.yml
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
version: '3.7' services: db: image: mariadb:10.6 container_name: nc-db restart: always command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW environment: MYSQL_ROOT_PASSWORD: "your_root_password" MYSQL_DATABASE: nextcloud MYSQL_USER: nextcloud MYSQL_PASSWORD: "your_password" volumes: - /volume1/docker/nextcloud/db:/var/lib/mysql app: image: nextcloud:19 container_name: nextcloud ports: - 8088:80 depends_on: - db environment: MYSQL_HOST: db MYSQL_DATABASE: nextcloud MYSQL_USER: nextcloud MYSQL_PASSWORD: "your_password" volumes: - /volume1/docker/nextcloud/app:/var/www/html - /volume1/nextcloud/data:/var/www/html/data restart: always |
Lưu ý: thay your_root_password và your_password bằng mật khẩu thực tế. Hai giá trị này phải khớp với database đang dùng trong Nextcloud cũ.
Bước 3: Cập Nhật File config.php
Mở file tại /volume1/docker/nextcloud/app/config/config.php, chỉnh các dòng sau:
|
1 2 3 |
'datadirectory' => '/var/www/html/data', 'dbhost' => 'db:3306', |
Kiểm tra lại các giá trị dbname, dbuser, dbpassword phải trùng khớp với thông số trong docker-compose.yml.
Bước 4: Phân Quyền Thư Mục
|
1 2 3 |
sudo chown -R 33:33 /volume1/docker/nextcloud/app sudo chown -R 33:33 /volume1/nextcloud/data |
Bước 5: Import Database Và Khởi Chạy
Khởi động container database trước để import:
|
1 2 3 |
cd /volume1/docker/nextcloud docker compose up -d db |
Import database cũ vào container:
|
1 2 |
docker exec -i nc-db mysql -u root -p nextcloud < /volume1/docker/nextcloud/nextcloud.sql |
Nếu lệnh trên bị treo hoặc báo lỗi, SSH thẳng vào container để import trực tiếp (copy file .sql vào đúng thư mục mount /var/lib/mysql của container trước).
Sau khi import xong, khởi động container Nextcloud:
|
1 2 |
docker compose up -d app |
Kiểm tra trạng thái Nextcloud:
|
1 2 |
docker exec -u www-data nextcloud php occ status |
Output trả về installed: true là thành công.
Lưu Ý Về Tường Lửa DSM
Nếu container khởi động nhưng không truy cập được hoặc database không kết nối được, kiểm tra DSM Firewall. DSM 7.x có lỗi chặn Docker bridge network — cần whitelist subnet 172.17.0.0/16 trong Control Panel → Security → Firewall. Chi tiết xem bài fix lỗi tường lửa Docker trên Synology.
Tổng Kết
Khi nâng cấp DSM 7 Nextcloud không chạy do PHP cũ bị loại bỏ, migrate sang Docker là giải pháp nhanh và ổn định hơn so với nâng cấp Nextcloud từng bước. Toàn bộ dữ liệu và database được giữ nguyên, chỉ thay đổi môi trường chạy từ native PHP sang container.
Nếu sau này muốn nâng Nextcloud lên phiên bản mới hơn, chỉ cần thay tag image trong docker-compose và chạy lần lượt từng phiên bản — đã có Docker thì bước này dễ kiểm soát hơn nhiều.
Tham khảo thêm hướng dẫn cài Nextcloud trên Synology bằng Docker tại mariushosting.com.
Xem thêm các bài viết kỹ thuật tại tungle.blog và chuyên mục Thủ thuật.
Bạn đang chạy Nextcloud phiên bản nào trên Synology? Gặp lỗi gì sau khi nâng DSM? Để lại bình luận bên dưới.
