【NAS DIY】Proxmox VE + Debian 13 LXC + Cockpit 打造 Samba NAS 教學

⚡ 30 秒速查：OpenMediaVault VM + NFS vs Debian LXC + Bind Mount#

📌 先說結論

這套架構的核心原則很簡單：Proxmox VE 管理儲存空間，Debian LXC 負責檔案分享。 ZFS 的 Pool、Snapshot、Quota 都在 PVE 處理，LXC 裡面只放 Samba 與管理介面。

一、NAS 架構規劃#

目前的架構如下：

1
Proxmox VE 9
2
│
3
├── ZFS Pool：tank
4
│   └── tank/nas
5
│       └── Share
6
│            └── Bind Mount → LXC /mnt/share
7
│
8
└── Debian 13 LXC
9
    ├── Cockpit
10
    ├── Cockpit Files
11
    ├── 45Drives File Sharing
12
    ├── 45Drives Identities
13
    └── Samba ➔ Windows SMB / macOS SMB

這樣設計有幾個好處：

• ZFS Pool 完全由 PVE 管理。
• 不需要額外的 NAS VM，也不需要 NFS 中繼。
• Samba 直接存取 Bind Mount 的目錄。
• Cockpit 提供 Web 管理介面。

其中 Share 就是一般的 ZFS 資料夾，之後要再切 Dataset、加 Quota 都可以在 PVE 端處理，不影響 LXC。

二、建立 Debian 13 LXC#

到 Proxmox VE 下載 Debian 13 Standard 的 Container Template，接著按 Create CT，建議配置如下：

⚠️ 關於 Privileged LXC

本文採用 Privileged LXC，主要是為了簡化 ZFS Bind Mount 與 Linux UID/GID 的對應。但它的隔離程度比較低，只適合可信任的內部服務。安全需求較高的話，請改用 Unprivileged LXC 搭配 UID/GID Mapping。

Debian 13 使用 systemd 257，建立時可能會看到 You may need to enable nesting 的警告，在 PVE Host 執行下面的指令即可：

1
pct set 1002 -features nesting=1
2
pct config 1002

本文的 NAS 不需要額外開啟 FUSE 或 Keyctl。

三、更新系統並安裝 Samba#

啟動並進入 LXC：

1
pct start 1002
2
pct enter 1002

更新套件並安裝基本工具：

1
apt update
2
apt full-upgrade -y
3
apt install -y sudo curl wget nano acl attr samba smbclient
4
systemctl enable --now smbd

四、安裝 Cockpit 與 Cockpit Files#

1
apt install -y cockpit
2
systemctl enable --now cockpit.socket

用瀏覽器開啟 https://10.0.0.2:9090（IP 請換成你自己的 NAS），第一次登入會出現自簽憑證警告，屬於正常情況。

Cockpit 可以管理系統資源、使用者、Services、Journal、Terminal 與系統更新。想要在網頁上瀏覽檔案，可以再裝官方的 Cockpit Files：

1
apt install -y cockpit-files

如果 Debian 套件來源沒有提供，就依照官方專案的說明安裝。

五、安裝 45Drives File Sharing 與 Identities#

要在網頁上管理 Samba 分享與 Linux 使用者，可以安裝 45Drives 的兩個 Cockpit 擴充套件：

• cockpit-file-sharing：管理 Samba / NFS 分享（Share Path、Read Only、Guest Access、Advanced Settings）。
• cockpit-identities：管理 Linux 使用者與群組。

安裝方式請照官方 README，加入 45Drives 的 APT 來源後再安裝。我目前正在運作的 NAS 實際安裝的版本如下：

⚠️ File Sharing v4 的變動

新版 File Sharing 已經沒有舊版「Valid Users / Groups」的圖形化選擇功能，要限制誰能登入，必須到 Advanced Settings 手動加入 Samba 參數（後面會示範）。

六、準備 ZFS 目錄並 Bind Mount 到 LXC#

回到 PVE Host，我的 ZFS Pool 叫 tank，NAS 主要目錄是 /tank/nas，底下的 Share 就是要分享的資料夾。全新環境可以先建立：

1
zfs create tank/nas
2
mkdir -p /tank/nas/Share
3
zfs list

若 tank/nas 已存在就不要重複建立，更不要覆蓋原有資料。

接著先停止 LXC，再把 Share 掛進去：

1
pct stop 1002
2
pct set 1002 -mp0 /tank/nas/Share,mp=/mnt/share
3
pct config 1002

重新啟動 LXC 並確認掛載：

1
pct start 1002
2
pct enter 1002
3
ls -lah /mnt/share

設定完成後，LXC 裡的 /mnt/share 就會對應到 PVE 的 /tank/nas/Share，Samba 只要分享 /mnt/share 就可以了。

📦 備份提醒

Bind Mount 的資料不會包含在一般的 LXC RootFS 備份裡，ZFS Dataset 請另外規劃 Snapshot、Replication 或異地備份。

七、使用者、群組與權限設計#

權限的做法是用 Linux 群組控管，Kent 實際使用的是「一個讀寫群組 + 一個唯讀群組」：

建立群組、使用者與 Samba 密碼：

1
groupadd data_rw
2
groupadd data_ro
3
adduser user1
4
usermod -aG data_rw user1
5
smbpasswd -a user1
6
pdbedit -L

📌 Linux 密碼 ≠ Samba 密碼

Linux 使用者與 Samba 使用者的密碼是兩套機制，要用 SMB 登入前，一定要先用 smbpasswd -a 建立 Samba 帳號。

接著設定目錄的群組、setgid 與 ACL：

1
chown root:data_rw /mnt/share
2
chmod 2770 /mnt/share
3
setfacl -m g:data_rw:rwx /mnt/share
4
setfacl -d -m g:data_rw:rwx /mnt/share
5
setfacl -m o:--- /mnt/share
6
setfacl -d -m o:--- /mnt/share
7
getfacl /mnt/share

setgid 讓新建立的子目錄繼承 data_rw 群組。要注意 Default ACL 只影響之後新建的項目，既有的檔案與子目錄需要另外檢查。

八、用 File Sharing 建立 Samba 分享#

進入 Cockpit 的 File Sharing ➔ Samba，新增第一個分享：

File Sharing v4 的分享是存在 Samba Registry 裡，所以 smb.conf 的 [global] 要有這一行（File Sharing 通常會自動加入，請先確認不要重複）：

1
[global]
2
include = registry

🔎 為什麼 smb.conf 裡找不到分享？

因為分享定義在 Registry，不在 smb.conf。要檢查請用 testparm -s 或 net conf list，不要直接去改 smb.conf 裡的 share 區段，改了也不會生效。

接著在 Share 的 Advanced Settings 加入權限參數。這是我目前實際使用的寫法：

1
valid users = @data_rw @data_ro
2
read list = @data_ro
3
force group = data_rw
4
create mask = 0664
5
directory mask = 2775
6
force directory mode = 2775

意思是：兩個群組都能登入，但 data_ro 在 read list 裡，所以只能讀；寫入的檔案則統一歸 data_rw 群組。另外 [global] 加上 macOS 相容設定，Mac 上的檔名與中繼資料會比較正常：

1
vfs objects = catia fruit streams_xattr
2
fruit:metadata = stream
3
fruit:encoding = native
4
fruit:zero_file_id = yes
5
fruit:nfs_aces = no

設定完用 testparm 檢查語法有沒有問題。

九、Windows 與 macOS SMB 測試#

Windows 在檔案總管輸入 \\10.0.0.2\Share，macOS 在 Finder 輸入 smb://10.0.0.2/Share，建議測試這些項目：

• 建立資料夾、中文檔名
• 上傳、下載、修改、刪除
• 不同群組使用者的權限（data_ro 要確認真的無法寫入）
• 大檔案傳輸

十、10GbE SMB 實測#

完成遷移後，Kent 在原本的 10GbE 區網環境做了測試。NAS 這台主機使用的網卡是 Mellanox ConnectX-3 CX312B，在 PVE 上用 lspci 查到的資訊如下：

1
01:00.0 Ethernet controller: Mellanox Technologies MT27520 Family [ConnectX-3 Pro]

這張卡是二手市場常見的 10GbE 網卡，Linux 內建驅動即可使用，價格也比較親民，很適合自組 NAS 的朋友參考。

少了 NFS 這一層，也不用再透過 OpenMediaVault VM 提供 SMB，讀取速度幾乎快了一倍，寫入也有明顯改善。

不過這是我自己環境的觀察結果，Samba 設定、快取、ZFS I/O、檔案大小與測試方式都會影響數字，不能直接說所有提升都來自 LXC，各位當作參考就好。

十一、運作現況檢查：怎麼確認 Samba 與 45Drives 都正常？#

建置完成後，Kent 也登入目前正在跑的那台 NAS 做了一次完整檢查（全程唯讀，沒有改任何設定），結果如下：

想自己檢查的話，這些指令就夠用了：

1
dpkg -l | grep -iE '45drives|cockpit|samba|winbind'
2
systemctl status smbd nmbd cockpit.socket
3
testparm -s
4
net conf list
5
pdbedit -L
6
smbstatus

⚠️ 別忘了限制網路存取

檢查時發現這台 NAS 沒有啟用任何防火牆規則，445、139 與 9090 對所有介面開放。NAS 只在家裡內網使用的話影響不大，但如果有任何對外路由或 Port Forward，建議用 PVE Firewall 或 LXC 內的防火牆，把這幾個埠限制在內網網段。

另外，如果 NAS 上同時有一顆不是 ZFS 的磁碟（例如我另外掛一顆 SSD 當下載區），要記得它沒有 ZFS 的 Snapshot 與冗餘保護，重要資料要另外備份。

十二、日常維護與舊 NAS VM 的移除#

日常維護可以分成兩邊：

Proxmox VE Host：ZFS Pool 健康、Scrub、Snapshot、Replication、Dataset Quota、空間監控。

1
zpool status
2
zfs list

Debian 13 LXC：Cockpit、Samba、使用者與群組、ACL、套件更新。

1
apt update && apt full-upgrade -y
2
systemctl status smbd
3
testparm
4
getfacl /mnt/share

新的 LXC NAS 穩定之後，才逐步淘汰舊的 NAS VM，建議流程：

1. 完成所有 Samba 分享，確認使用者與 ACL。
2. 測試 Windows、macOS。
3. 確認其他設備不再使用舊 NAS 的 IP。
4. 關閉舊 VM，觀察一段時間。
5. 保留一份可還原的 VM 備份，最後才正式移除。

⚠️ 刪 VM 前先看清楚

如果舊 VM 只是透過 NFS 存取 PVE 上的 ZFS 資料，刪除前務必確認虛擬磁碟、掛載設定與實際資料的關係，避免誤刪真正的資料。

總結#

用 Proxmox VE 建 NAS，不一定要再裝一套完整的 NAS 作業系統。對已經由 PVE 管理 ZFS 的環境來說，Debian 13 LXC + Cockpit + Samba 是很值得考慮的組合：

• PVE 管理 ZFS，LXC 提供 Samba，Cockpit 提供 Web 管理。
• 群組加 ACL 管理檔案權限，一個讀寫群組加一個唯讀群組就很夠用。
• 不再需要 NAS VM 與 NFS，10GbE SMB 讀取約 1GB/s、寫入約 800～900MB/s。

如果你也熟悉 Linux，又想把 NAS 整合進 Proxmox VE 的 Homelab，這是一套簡潔又容易長期維護的架構，推薦給大家試試看！

延伸閱讀#

👉 【NAS DIY】舊電腦先別丟!! 安裝 TrueNAS 15分鐘打造高效能網路硬碟
👉 【NAS DIY】QNAS MINI好用嗎? 入坑心得分享!!
👉 【NAS DIY】5分鐘添加TrueCharts軟體庫，讓TrueNAS有更多內建APP