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