Nextcloud Docker lưu file ở đâu? Tìm volume trên host
Tìm đúng data directory trong container, đường dẫn volume trên host và 3 volume cần backup để khôi phục Nextcloud, không chỉ chép file người dùng.
Nextcloud trong Docker lưu file ở đâu
Nextcloud trong Docker lưu file trong một thư mục dữ liệu bên trong container. Vị trí thực trên server là volume hoặc bind mount mà bạn gắn vào container. Với image linuxserver.io, lscr.io/linuxserver/nextcloud, file người dùng nằm trong /data, còn config.php, app và theme nằm dưới /config. Cả hai đều là đường dẫn trong container. Một lệnh có thể in ra đường dẫn trên host tương ứng với các đường dẫn này. Phần còn lại của hướng dẫn giải thích nửa khó hơn của câu hỏi: mọi thứ mà thư mục dữ liệu không chứa.
Ghim image tag. Đường dẫn phụ thuộc vào image, không phải riêng Nextcloud, và tag trỏ động có thể thay đổi mà bạn không biết. Tính đến ngày 20 tháng 11 năm 2026, bản stable hiện tại của image là 35.0.3-ls3, chứa Nextcloud 35.0.3, bản release thứ tư của major version Nextcloud 35. Image chỉ nâng cấp từng major version một lần, nên stack vẫn ở 34.x sẽ chuyển lên 35 trong một bước. Hãy backup trước khi thực hiện bước đó.
services:
nextcloud:
image: lscr.io/linuxserver/nextcloud:35.0.3-ls3
container_name: nextcloud
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
volumes:
- nextcloud_config:/config
- nextcloud_data:/data
ports:
- 443:443
restart: unless-stopped
nextcloud-db:
image: mariadb:11.8
container_name: nextcloud-db
environment:
- MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
- MARIADB_DATABASE=nextcloud
- MARIADB_USER=nextcloud
- MARIADB_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
volumes:
- nextcloud_db:/var/lib/mysql
restart: unless-stopped
volumes:
nextcloud_config:
nextcloud_data:
nextcloud_db:Hai password được lấy từ file .env nằm cạnh file compose, nên không xuất hiện trong chính file compose. Như vậy có ba volume trong câu trả lời, nhưng chỉ một volume chứa file người dùng.
Các đường dẫn trong container đó lấy từ tài liệu của image này. Image Nextcloud khác có thể bố trí filesystem khác và đặt bộ cài dưới web root riêng, nên đường dẫn chép từ một bài đăng trên forum chỉ là phỏng đoán. Hãy đọc thông tin chính xác từ container bạn đang chạy.
docker inspect nextcloudPhần Mounts trong output đó liệt kê mọi mount, với Source ở phía host và Destination ở phía container. Danh sách này trả lời chính xác câu hỏi cho thiết lập của bạn, bất kể bạn chọn image nào.
Làm thế nào để tìm đường dẫn thật trên host phía sau volume?
Named volume do Docker quản lý, nên bạn không tự chọn đường dẫn. Hãy yêu cầu Docker trả về đường dẫn đó.
docker volume ls
docker volume inspect nextcloud_nextcloud_dataTên volume rất quan trọng. Docker Compose thêm tiền tố tên project vào tên volume. Mặc định, tên project là tên của thư mục chứa file compose. Vì vậy, volume được ghi là nextcloud_data trong file thường tồn tại dưới tên nextcloud_nextcloud_data trên disk. docker volume ls hiển thị tên thật. Output của lệnh inspect có dạng như sau, đã được rút gọn:
[
{
"CreatedAt": "2026-08-18T09:12:44Z",
"Driver": "local",
"Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
"Name": "nextcloud_nextcloud_data",
"Scope": "local"
}
]Mountpoint là câu trả lời. Hãy đọc đường dẫn từ command thay vì tự đoán, vì đường dẫn này có thể thay đổi. Với Docker rootless, toàn bộ Docker data root mặc định nằm trong home directory của user chạy daemon, nên đường dẫn sẽ bắt đầu ở vị trí khác.
Bind mount loại bỏ câu hỏi này. Ghi - /srv/nextcloud/data:/data vào file compose. Đường dẫn trên host chính là đường dẫn bạn đã nhập, và docker inspect báo cáo đường dẫn đó là Source. Lựa chọn này thay đổi nhiều hơn chỉ đường dẫn, vì named volume và bind mount có cách xử lý ownership và backup khác nhau.
Vì sao data directory không phải là bản backup
Tài liệu Nextcloud liệt kê 5 thành phần mà một bản backup phải giữ: thư mục config, thư mục custom apps, thư mục data, thư mục theme và database. Với image này, các thư mục config, apps và theme đều nằm dưới /config, còn database chạy trong container riêng với volume riêng. Chỉ copy /data nghĩa là bạn mới lưu phần ít quan trọng nhất của vấn đề.
Database quan trọng vì giao diện web không liệt kê trực tiếp các file trong một thư mục. Nó liệt kê các row từ file cache. Vì vậy, tài liệu yêu cầu bạn chạy lệnh scan sau khi chép file thủ công vào data directory. Khôi phục /data bên cạnh một database trống sẽ tạo ra các byte không có index: không có user, không có share và không có gì trong danh sách file. Khôi phục database bên cạnh một /data trống thì mọi row đều trỏ đến một file đã mất.
config.php chứa thông tin xác thực của database và các trusted domain. Nó cũng chứa instance id. Khi thêm tiền tố appdata_, instance id này tạo thành tên của app data folder. Hãy hỏi instance đang chạy thay vì tin vào một trong hai giá trị này từ trí nhớ.
docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceidLệnh đầu tiên in ra data directory mà instance này thực sự sử dụng; ở đây là /data. Image này cung cấp một wrapper occ trong PATH, vì vậy hãy chạy trực tiếp qua docker exec. Không copy dạng dài hơn sudo và php occ trong tài liệu Nextcloud, vì dạng đó dành cho bản cài đặt chạy bên ngoài container.
Điều gì đang âm thầm làm đầy data volume?
Preview và lịch sử riêng của từng user nằm cùng volume với các file, nhưng cả hai không được tính vào dung lượng mà user thấy trong web interface.
- Preview là thumbnail được tạo tự động. Chúng nằm trong thư mục app data bên trong data directory, có tên là
appdata_theo sau là instance id. - File đã xóa vẫn nằm trong trash.
trashbin_retention_obligationmặc định làauto. Thiết lập này cho phép file đã xóa tồn tại quá 30 ngày khi còn đủ dung lượng, nhưng cũng cho phép xóa trước 30 ngày khi cần giải phóng dung lượng. File đã xóa không tính vào quota thông thường của user, nhưng trash có giới hạn riêng: mặc định tối đa bằng 50% dung lượng quota còn lại của user, hoặc bằng dung lượng disk còn trống đối với user không có quota. Khi trash vượt giới hạn đó, Nextcloud xóa các item đủ điều kiện cũ nhất trước, bao gồm cả item chưa đủ 30 ngày khi dùngauto. - Các version cũ cũng vẫn được giữ lại.
versions_retention_obligationmặc định làauto. Thiết lập này dần giảm số version theo thời gian và giữ lại version mới nhất trong mỗi khoảng thời gian. Khi cấu hình thời gian lưu tối đa, background job sẽ xóa các version quá thời hạn hoặc có file không còn tồn tại. Với account có quota, app Versions nhắm đến 50% dung lượng quota hiện còn trống của user. Không có quota thì app dùng trực tiếp dung lượng filesystem còn trống. Khi cần giải phóng dung lượng, app xóa các version cũ nhất trước nhưng vẫn giữ ít nhất 2 version gần nhất, nên đây không phải giới hạn cứng. Version được user đặt tên thủ công sẽ không bị cơ chế expiration tự động xóa, nhưng user vẫn có thể xóa thủ công;occ versions:cleanupcũng xóa các version đã đặt tên cùng với các version khác.
Hãy đo trước khi xóa bất kỳ thứ gì.
docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'Dòng đầu tiên đưa ra một số liệu cho mỗi thư mục user và một số liệu cho app data folder. Nếu số liệu của app data lớn, hãy kiểm tra subdirectory preview. App data cũng chứa avatar và asset được cache. Các lệnh cleanup bên dưới đều có tài liệu mô tả, và mỗi lệnh đều chủ động hủy dữ liệu.
docker exec -it nextcloud occ trashbin:cleanup --all-users
docker exec -it nextcloud occ versions:cleanup alice
docker exec -it nextcloud occ preview:cleanuppreview:cleanup xóa mọi preview đã tạo. Nextcloud sẽ tạo lại chúng khi user mở các file đó, nên dung lượng sẽ dần tăng trở lại và CPU phải xử lý việc tạo lại. Nếu volume chỉ là một phần của vấn đề disk rộng hơn, image cũ và build cache lỗi thời thường là phần còn lại.
Vì sao các file tôi copy vào host không xuất hiện trong Nextcloud?
Vì Nextcloud đọc cache file trong database, không đọc trực tiếp từ thư mục. Lệnh copy của bạn đã tạo file trên disk nhưng không có row tương ứng trong database, nên web interface không có gì để hiển thị. Tài liệu hướng dẫn nêu đúng trường hợp này: cần chạy scan sau khi copy file trực tiếp vào data directory.
docker exec -it nextcloud occ files:scan --path="/alice/files/Photos"
docker exec -it nextcloud occ files:scan --all --unscanned -v
docker exec -it nextcloud occ files:scan --allĐối số --path cũng cho thấy cấu trúc bên trong data directory: mỗi user có một thư mục được đặt theo username của họ, còn files bên trong thư mục đó chứa các file họ nhìn thấy trên web interface. Hãy scan một path khi bạn biết file đã được copy vào đâu. --all sẽ duyệt qua mọi user và mất nhiều thời gian trên instance lớn. --unscanned chỉ xử lý các file được đánh dấu là chưa scan xong. -v in từng file khi xử lý, giúp bạn phân biệt giữa lệnh có vẻ bị treo và lệnh mà bạn có thể theo dõi tiến trình.
Quyền sở hữu quyết định việc scan có đủ hay không. Nếu container user không có quyền ghi vào file, file vẫn được index nhưng không thể di chuyển. Khi đó danh sách hiển thị đúng, nhưng thao tác rename hoặc delete từ web interface sẽ fail.
Vì sao thao tác ghi vẫn thất bại sau khi tôi đặt PUID và PGID?
Vì kernel so sánh các giá trị số, không so sánh tên. PUID và PGID đặt user id (uid) và group id (gid) dạng số mà process trong container sử dụng. Mỗi file trên host cũng có owner dạng số. Khi hai giá trị này khác nhau, thao tác ghi sẽ bị từ chối, dù tên ở hai phía trông giống nhau.
docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_dataid abc in ra uid và gid mà container thực sự sử dụng. Đây là các giá trị PUID và PGID bạn đã đặt. ls -ln in ra owner dạng số, còn -n rất quan trọng: ls -l thông thường chuyển các giá trị đó qua danh sách user của host và hiển thị một tên không có ý nghĩa bên trong container. Hãy so sánh hai giá trị số.
Sau đó, hãy kiểm tra thao tác ghi thay vì đoán.
docker exec -u abc -it nextcloud touch /data/writetestMột Permission denied có tên /data là bằng chứng xác nhận. Hãy sửa ownership từ bên trong container, rồi chạy lại cùng bài kiểm tra.
docker exec -u 0 -it nextcloud chown -R abc:abc /data
docker exec -u abc -it nextcloud touch /data/writetest
docker exec -u abc -it nextcloud rm /data/writetestCó lý do để thực hiện việc này từ bên trong container. Với rootless Docker, user id của container được ánh xạ qua dải subordinate trong /etc/subuid, nên uid 1000 bên trong container tương ứng với một uid cao hơn nhiều trên host. Khi đó, chown 1000:1000 chạy trên host sẽ đặt owner mà container không thể sử dụng, và thao tác ghi vẫn thất bại. Chạy chown bên trong container sử dụng cùng mapping mà process Nextcloud sử dụng, nên các giá trị số tự khớp với nhau. Đây cũng là lý do PUID và PGID phải khớp với owner trên disk trước khi bạn bắt đầu debug các vấn đề khác.
Cách backup để restore thực sự hoạt động?
Lấy database và các thư mục tại cùng một thời điểm. Maintenance mode chặn đăng nhập, nên không có file upload nào được ghi vào giữa lúc dump và lúc copy.
docker exec -it nextcloud occ maintenance:mode --on
docker exec nextcloud-db mariadb-dump --single-transaction -u nextcloud -p"$NEXTCLOUD_DB_PASSWORD" nextcloud > nextcloud-sqlbkp.sql
docker run --rm -v nextcloud_nextcloud_data:/data:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-data.tgz -C /data .
docker run --rm -v nextcloud_nextcloud_config:/config:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-config.tgz -C /config .
docker exec -it nextcloud occ maintenance:mode --offLưu ý dòng dump không có gì: không có flag -t. TTY sẽ viết lại ký tự kết thúc dòng. SQL dump đã đi qua TTY có thể bị hỏng theo cách chỉ phát hiện được khi restore. Cũng lưu ý rằng password trên command line sẽ hiển thị trong output của ps khi command đang chạy. Đọc password từ file .env vào shell giúp bạn không phải nhập password vào shell history, nhưng không che được tham số command line sau khi shell đã mở rộng. Các database image cũ dùng mysqldump thay cho mariadb-dump. Manual mô tả cả hai.
Để restore, hãy nạp dump vào một database trống, giải nén cả hai archive vào volume mới, khởi động các container, rồi tắt maintenance mode. Nếu các thư mục và dump được tạo ở các thời điểm khác nhau, file cache và disk sẽ không nhất quán. occ files:scan --all chỉ sửa được một chiều. Nó tìm các file đang tồn tại nhưng không có row tương ứng. Nó không thể khôi phục file mà một row đang trỏ tới.
Lưu bản backup bên ngoài server. Bản copy nằm trên cùng VPS sẽ mất cùng VPS. Vì vậy, dùng restic đến repository trên server khác là một phần của quy trình này. Provider snapshot là công cụ khác với backup. Nếu bạn vẫn đang dựng stack, cài Nextcloud đầy đủ trên VPS có hướng dẫn về reverse proxy và chứng chỉ TLS (transport layer security) mà guide này không đề cập.
FAQ
Thư mục dữ liệu Nextcloud nằm ở đâu trong Docker container?
Với image linuxserver.io, thư mục này nằm tại /data bên trong container. config.php, apps và themes nằm dưới /config. Đây là các đường dẫn bên trong container. Để biết đường dẫn trên host, chạy docker inspect nextcloud rồi đọc giá trị Source trong phần Mounts, hoặc chạy docker volume inspect trên volume rồi đọc Mountpoint. Các image Nextcloud khác dùng đường dẫn bên trong container khác, vì vậy hãy kiểm tra tài liệu của tag bạn đã pin và xác nhận bằng docker exec -it nextcloud occ config:system:get datadirectory.
Vì sao các file tôi copy vào volume không xuất hiện trong Nextcloud?
Nextcloud liệt kê các bản ghi từ file cache trong database thay vì đọc trực tiếp thư mục. Vì vậy, file được đưa vào mà không đi qua Nextcloud sẽ không có bản ghi và vẫn bị ẩn. Chạy docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" cho một thư mục hoặc occ files:scan --all cho tất cả user. Nếu file xuất hiện nhưng sau đó không thể di chuyển hoặc xóa, nguyên nhân là ownership: user bên trong container phải có quyền ghi vào các file đó.
Chỉ sao chép data volume có đủ để khôi phục Nextcloud không?
Không. Data volume chứa nội dung file. Database chứa file index cùng với user và share, còn config.php chứa thông tin xác thực database và instance id. Một lần khôi phục đầy đủ cần có data folder, config folder, database, cùng các custom apps và theme folder nếu bạn sử dụng chúng. Hãy lấy tất cả từ cùng một thời điểm, vì database mới hơn các file sẽ trỏ đến những file không tồn tại.
Vì sao data volume của tôi lớn hơn nhiều so với các file user nhìn thấy?
Preview, file đã xóa và version cũ nằm trong cùng volume, nhưng không mục nào xuất hiện trong dung lượng mà user nhìn thấy. Đo dung lượng bằng docker exec -it nextcloud sh -c 'du -sh /data/*'. Theo mặc định, trash can sẽ xóa các file cũ hơn 30 ngày khi cần giải phóng dung lượng và giữ chúng lâu hơn khi chưa cần. Việc dọn version nhắm đến một nửa dung lượng quota còn lại đối với account có quota và dùng trực tiếp dung lượng trống của filesystem trong các trường hợp khác. Việc giữ các version gần đây có thể khiến mục tiêu này không đạt được. Xóa chúng bằng occ trashbin:cleanup --all-users, occ versions:cleanup alice và occ preview:cleanup. Preview có thể tăng trở lại khi user mở file.
Tôi có thể chuyển thư mục dữ liệu Nextcloud sang disk khác không?
Hãy mount vị trí mới vào cùng đường dẫn bên trong container thay vì thay đổi đường dẫn mà Nextcloud biết. Dừng container, copy toàn bộ nội dung cũ sang disk mới và giữ nguyên ownership (cp -a hoặc rsync -aAX), trỏ volume hoặc bind mount đến vị trí mới trong file compose, rồi khởi động lại. Nextcloud vẫn thấy /data, nên không cần thay đổi bản ghi nào trong database. Xác nhận bằng docker exec -it nextcloud occ config:system:get datadirectory và thực hiện một lần upload thử.