DX4600 Docker部署Alist全攻略:端口映射與網(wǎng)盤掛載避坑指南)
簡介這份資源是面向綠聯(lián) NAS 用戶的 Docker 實(shí)戰(zhàn)圖文教程聚焦在綠聯(lián) DX4600同樣適用于 DH2600上部署 Alist 并掛載網(wǎng)盤這一常見需求適合剛接觸 NAS 容器、希望把阿里云盤、115 網(wǎng)盤等統(tǒng)一管理的入門用戶也適合想少走彎路、按圖索驥完成配置的進(jìn)階玩家。資源包共 1 個(gè) PDF 文件約 2.91MB內(nèi)容以圖文步驟為主從鏡像搜索、容器創(chuàng)建、存儲空間與端口設(shè)置到初始密碼查找、登錄改密再到阿里云盤刷新令牌填寫與 115 網(wǎng)盤 Cookie 獲取均有對應(yīng)截圖與說明目錄按容器配置、網(wǎng)盤掛載分節(jié)引導(dǎo)便于對照操作。目前已有 912 人學(xué)習(xí)說明該教程在同類場景中具備一定參考價(jià)值。讀者可借此掌握 Alist 容器的完整搭建流程與常見網(wǎng)盤掛載思路理解端口、存儲映射、重啟策略等關(guān)鍵配置項(xiàng)并能在遇到鏡像下載、密碼獲取等問題時(shí)快速定位減少反復(fù)試錯(cuò)的時(shí)間成本。1. 綠聯(lián) DX4600 上跑 Alist一個(gè)端口填錯(cuò)就能折騰一晚上的容器活第一次在綠聯(lián) DX4600 上裝 Alist我把本地端口隨手改成了 5244 之外的數(shù)字結(jié)果容器起來了、日志也正常瀏覽器就是打不開來回重啟了四五次才反應(yīng)過來是端口映射和訪問地址對不上。這類 NAS 上的 Docker 部署坑往往不在鏡像本身而在存儲路徑、端口、重啟策略這幾個(gè)參數(shù)上。這篇記錄的是綠聯(lián) DX4600同系列 DH2600 的 Docker 界面基本一致從拉鏡像到掛載網(wǎng)盤的完整過程適合剛上手 NAS 容器、想把網(wǎng)盤統(tǒng)一掛到一個(gè)入口的開發(fā)者。群暉和極空間的界面邏輯不同參數(shù)思路可以借鑒但按鈕位置別照搬。2. 裝前把環(huán)境列清楚鏡像、目錄、端口三件事2.1 鏡像怎么選認(rèn)準(zhǔn) xhofe/alist 這個(gè)倉庫名綠聯(lián)的 Docker 主界面走的是「鏡像管理 → 本地鏡像 → 添加」這條路徑彈窗里給的是官方庫搜索框直接輸xhofe回車列表第一個(gè)就是xhofe/alist。這里有個(gè)版本取舍不寫 tag 默認(rèn)拉latest對個(gè)人 NAS 場景夠用因?yàn)?Alist 的配置都落在掛載出來的data目錄里升級鏡像不會丟數(shù)據(jù)如果你追求可回滾可以在搜索時(shí)手動(dòng)指定具體版本 tag把版本號記在自己的部署筆記里出問題能退回去。鏡像體積不小下載過程會出現(xiàn)進(jìn)度條完成后顯示All done點(diǎn)「完成」即可。如果本地鏡像列表里沒看到剛下的鏡像點(diǎn)右上角「刷新」這是綠聯(lián)界面緩存沒及時(shí)更新的常見現(xiàn)象不是下載失敗。2.2 存儲目錄先建好Docker/alist/data 三級結(jié)構(gòu)這一步是整個(gè)部署里最容易被跳過、也最容易翻車的地方。原文的操作是提前在存儲空間根目錄建好Dockeralistdata三級文件夾然后在容器創(chuàng)建時(shí)把宿主機(jī)的這個(gè)data目錄映射到容器內(nèi) Alist 的數(shù)據(jù)目錄。我一般會在創(chuàng)建容器之前就把目錄建完避免在映射界面里臨時(shí)找路徑找錯(cuò)層級。目錄結(jié)構(gòu)建議固定成下面這樣后面遷移或者備份都省事# 在 NAS 的存儲空間根目錄下建立三級目錄 # 假設(shè)你選的是 M.2 硬盤 2 這個(gè)存儲空間 /Docker /alist /data # 映射給容器存 Alist 的配置和數(shù)據(jù)庫data目錄是 Alist 的「黑匣子」賬號密碼、存儲掛載配置、令牌全在里面。映射時(shí)右側(cè)的權(quán)限必須從默認(rèn)的「只讀」改成「讀寫」否則容器能啟動(dòng)但寫不進(jìn)配置表現(xiàn)為登錄后改密碼不生效、添加存儲報(bào)錯(cuò)。這個(gè)只讀/讀寫的開關(guān)就在存儲空間設(shè)置那一欄點(diǎn)一下切換別漏。2.3 端口和重啟策略5244 與「容器退出時(shí)總是重啟」端口設(shè)置里本地端口填5244這是 Alist 的默認(rèn) Web 端口。原文特別強(qiáng)調(diào)小白別亂改原因很實(shí)際后面訪問要用NAS的IP:5244端口一改你記的地址、桌面快捷方式、甚至路由器上的端口轉(zhuǎn)發(fā)全要跟著改排查時(shí)容易把「端口不對」誤判成「服務(wù)沒起來」。如果 5244 已經(jīng)被別的容器占用換一個(gè) 5000 以上的空閑端口然后把這個(gè)數(shù)字寫在便簽上。重啟策略選「容器退出時(shí)總是重啟容器」。NAS 會定時(shí)重啟、斷電恢復(fù)、Docker 服務(wù)重載不選這個(gè)策略Alist 掛了就得手動(dòng)點(diǎn)啟動(dòng)。這條不是強(qiáng)制項(xiàng)但對長期掛網(wǎng)盤的服務(wù)來說選上能省掉很多「怎么突然打不開了」的疑問。3. 創(chuàng)建容器高級模式里只動(dòng)存儲和端口兩處3.1 從鏡像創(chuàng)建容器并進(jìn)入高級模式在「鏡像管理 → 本地鏡像」里找到xhofe/alist點(diǎn)鏡像下方的「創(chuàng)建容器」。彈出的向?qū)Ю锵劝讶萜髅Q改掉默認(rèn)名往往是一串鏡像名加隨機(jī)后綴后期容器一多根本分不清誰是誰我一般命名成alist或者alist-main跟用途掛鉤。改完名稱打開「高級模式」點(diǎn)「下一步」進(jìn)入詳細(xì)配置頁。高級模式里參數(shù)很多但 Alist 這個(gè)容器真正需要?jiǎng)拥闹挥小复鎯臻g」和「端口設(shè)置」兩塊其余保持默認(rèn)。原文也點(diǎn)明了這一點(diǎn)不同容器的填法不一樣別把 Alist 的配置習(xí)慣套到別的鏡像上。3.2 存儲空間映射選對硬盤、選對 data 目錄、改成讀寫點(diǎn)上方「存儲空間」標(biāo)簽在「自動(dòng)」那一欄選擇你存放 Docker 的硬盤。原文作者放在 M.2 硬盤 2你按自己實(shí)際的存儲空間選原則是選容量夠、讀寫穩(wěn)定的那塊別選到外接 U 盤或者即將寫滿的盤上。然后雙擊進(jìn)入剛才建好的Dockeralistdata選中data文件夾后點(diǎn)右下角「選擇」。映射關(guān)系確認(rèn)后把右側(cè)的「只讀」點(diǎn)一下切成「讀寫」。這一步的判斷標(biāo)準(zhǔn)很簡單容器里 Alist 要往這個(gè)目錄寫數(shù)據(jù)庫和配置只讀掛載等于給它戴了手銬。宿主機(jī)路徑/存儲空間/Docker/alist/data 容器內(nèi)路徑/opt/alist/data 權(quán)限讀寫容器內(nèi)路徑以鏡像實(shí)際約定為準(zhǔn)創(chuàng)建向?qū)Ю锶绻呀?jīng)預(yù)填了容器路徑保持不動(dòng)只核對宿主機(jī)這一側(cè)指向的是你建的data。路徑層級錯(cuò)一級比如指到了alist而不是alist/dataAlist 會把配置散落在上層目錄后面?zhèn)浞輹r(shí)容易漏。3.3 端口映射與完成創(chuàng)建點(diǎn)上方「端口設(shè)置」本地端口填5244容器端口保持鏡像默認(rèn)。填完點(diǎn)「下一步」再點(diǎn)「完成」。回到「容器管理」找到剛建的alist容器點(diǎn)下方的「啟動(dòng)」。啟動(dòng)后狀態(tài)變成運(yùn)行中點(diǎn)右側(cè)「快捷方式」可以在桌面生成入口也可以直接在局域網(wǎng)瀏覽器里輸NAS的IP:5244注意中間是英文冒號。訪問不通時(shí)按這個(gè)順序查容器是否在運(yùn)行 → 端口是否被占用 → 防火墻或安全組是否放行 → IP 是否填錯(cuò)。大部分「打不開」都落在前兩項(xiàng)跟鏡像本身沒關(guān)系。4. 首次登錄與密碼修改初始密碼藏在容器日志里4.1 從日志里撈初始密碼第一次打開IP:5244會進(jìn)到 Alist 登錄頁用戶名默認(rèn)admin密碼不是固定的得去容器日志里找。回到容器管理點(diǎn)alist容器的「詳情」上方切到「日志」用鼠標(biāo)往下滑找到包含password的那一行它后面跟的一串就是初始密碼。復(fù)制回去填上登錄。日志里信息不少找的時(shí)候認(rèn)準(zhǔn)password這個(gè)關(guān)鍵詞別把旁邊的時(shí)間戳或者路徑當(dāng)成密碼。如果日志滾動(dòng)太快沒抓到停一下容器再啟動(dòng)初始密碼會在啟動(dòng)日志里重新打印一次。4.2 改掉 admin 密碼順手處理 guest 賬號登錄后點(diǎn)左側(cè)「用戶」右側(cè)列表里能看到admin和幾個(gè)guest賬號。點(diǎn)「編輯」把 admin 的密碼改成自己的改完會要求重新登錄這是正常流程。guest 賬號按需處理不需要匿名訪問就把 guest 的密碼也改掉或者直接禁用需要分享只讀入口再保留。這一步別嫌麻煩。Alist 掛的是網(wǎng)盤admin 權(quán)限等于你所有掛載盤的鑰匙初始密碼是公開在日志里的不改等于門沒鎖。5. 掛載網(wǎng)盤阿里云盤填令牌115 抓 Cookie5.1 阿里云盤刷新令牌是唯一要自己拿的字段點(diǎn)左側(cè)「存儲」上方「添加」選擇阿里云盤驅(qū)動(dòng)。表單里除了「刷新令牌」其余字段照抄官方文檔給的默認(rèn)值即可掛載路徑自己起個(gè)名字比如/aliyun。刷新令牌的獲取方式 Alist 官方文檔有專門頁面按步驟授權(quán)后拿到一串 token復(fù)制進(jìn)「刷新令牌」框點(diǎn)「保存」。保存后回到存儲列表狀態(tài)顯示正常就說明掛載成功。如果報(bào)錯(cuò)先核對 token 有沒有復(fù)制完整首尾容易漏字符再看掛載路徑有沒有和已有存儲重名。阿里云盤的令牌有有效期過期后需要重新獲取這是這類網(wǎng)盤掛載的常態(tài)不是配置寫錯(cuò)了。5.2 115 網(wǎng)盤F12 抓 Cookie 的完整動(dòng)作115 網(wǎng)盤走的是 Cookie 方式。打開 115 網(wǎng)盤網(wǎng)頁版并登錄按 F12 打開開發(fā)者工具再按 F5 刷新頁面在 Network 面板里找主文檔請求復(fù)制請求頭里的 Cookie 整串值?;氐?Alist 存儲添加頁選 115 驅(qū)動(dòng)掛載路徑自己填把 Cookie 粘進(jìn)對應(yīng)框點(diǎn)「添加」。掛載路徑/115 # 自定義別和已有存儲沖突 Cookie從瀏覽器開發(fā)者工具復(fù)制的整串值Cookie 里包含登錄態(tài)復(fù)制時(shí)不要帶多余空格或換行粘進(jìn)去后保存看狀態(tài)。其他網(wǎng)盤的掛載邏輯基本一致要么給令牌要么給 Cookie區(qū)別只在字段名。掛載完成后在 Alist 首頁點(diǎn)進(jìn)對應(yīng)目錄能列出文件、能下載才算真正跑通。6. 裝完怎么驗(yàn)證三步確認(rèn)這套 Alist 真的能用6.1 容器層驗(yàn)證狀態(tài)、日志、重啟策略先看容器管理里alist的狀態(tài)是不是運(yùn)行中點(diǎn)「詳情」看日志有沒有持續(xù)報(bào)錯(cuò)。再確認(rèn)重啟策略生效手動(dòng)重啟一次 NAS 或者重啟 Docker 服務(wù)等幾分鐘后容器應(yīng)該自己起來不需要你手動(dòng)點(diǎn)啟動(dòng)。這一步能提前暴露「重啟后服務(wù)不在」的問題比等真正斷電時(shí)才發(fā)現(xiàn)強(qiáng)。6.2 服務(wù)層驗(yàn)證登錄、改密、掛載列表瀏覽器訪問IP:5244用改過的 admin 密碼登錄進(jìn)「存儲」看每個(gè)掛載項(xiàng)的狀態(tài)。逐個(gè)點(diǎn)進(jìn)掛載目錄確認(rèn)能列目錄、能打開文件。阿里云盤重點(diǎn)看令牌是否過期115 重點(diǎn)看 Cookie 是否還有效。任何一項(xiàng)狀態(tài)異常先單獨(dú)修那一項(xiàng)別整體重裝。6.3 數(shù)據(jù)層驗(yàn)證data 目錄有沒有真的寫進(jìn)去最后回到 NAS 文件管理進(jìn)Docker/alist/data確認(rèn)里面有 Alist 生成的數(shù)據(jù)庫和配置文件且修改時(shí)間是你最近操作的時(shí)間。如果目錄是空的或者時(shí)間停在創(chuàng)建那一刻說明讀寫映射沒生效回去把存儲空間的「只讀」改成「讀寫」再重啟容器。驗(yàn)證項(xiàng)看哪里正常表現(xiàn)容器狀態(tài)容器管理列表運(yùn)行中重啟后自動(dòng)恢復(fù)Web 訪問瀏覽器 IP:5244登錄頁正常admin 可登錄網(wǎng)盤掛載存儲列表 目錄瀏覽狀態(tài)正常能列文件數(shù)據(jù)落盤Docker/alist/data有數(shù)據(jù)庫文件時(shí)間隨操作更新這套驗(yàn)證我一般部署完當(dāng)場走一遍尤其是數(shù)據(jù)落盤那一步很多人只看到網(wǎng)頁能開就以為成了結(jié)果一重啟配置全丟回頭還得重掛一遍網(wǎng)盤。從那以后我每次在 NAS 上起新容器都強(qiáng)制把「重啟后是否自恢復(fù)」和「數(shù)據(jù)目錄是否真寫入」這兩條走一遍省下的返工時(shí)間遠(yuǎn)比這幾分鐘多。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取