在 VPS 上用 Docker Compose 自架 Mealie 食譜管理器
學會在 VPS 以 Docker Compose 部署 Mealie,貼上食譜網址即可擷取乾淨步驟,並設定餐點計畫、購物清單、nginx、TLS 與備份。
自架食譜管理工具的功能
自架食譜管理工具會將食譜儲存在自有伺服器的資料庫中,而 Mealie 是多數家庭最後會選用的工具。您只要貼上食譜網頁的網址,Mealie 就會讀取其中的食材、步驟、份量與烹調時間,並排除故事內容與廣告。最後加入收藏的只有食譜內容。
應用程式的其他功能很精簡。您可以將食譜拖曳到每週餐點計畫中,購物清單則會依據該計畫建立。每位下廚者都能使用自己的登入帳號。所有功能都在單一容器中執行,沒有請求時幾乎不會使用資源,因此一般 VPS 就能穩定承載。
本指南使用 Docker Compose。如果您不熟悉 services: 與 volumes:,請先閱讀 Docker Compose 檔案的組成方式,因為以下內容就是一個 compose 檔案與四個命令。
使用 Docker Compose 安裝 Mealie
Mealie 會將映像檔發布至 GitHub container registry。截至 2026 年 11 月 18 日,目前的穩定標籤為 v3.31.0,於 11 月 13 日發布。此版本包含安全性修正,專案建議所有人更新。請固定指定版本,不要使用 latest:使用 latest 時,某天發布的 docker compose pull 可能會讓版本跨越尚未準備好的資料庫 migration。
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.31.0
container_name: mealie
restart: always
ports:
- "127.0.0.1:9925:9000"
deploy:
resources:
limits:
memory: 1000M
volumes:
- mealie-data:/app/data/
environment:
ALLOW_SIGNUP: "false"
PUID: 1000
PGID: 1000
TZ: Europe/Amsterdam
BASE_URL: https://recipes.example.com
volumes:
mealie-data:開始前,請先查看以下兩行。
連接埠寫成 127.0.0.1:9925:9000,而不是 9925:9000。容器內部監聽 9000,主機則將 9925 對應至該連接埠。將此對應綁定至 loopback 位址後,nginx 可以連線至 Mealie,網際網路則無法連線。Docker 會自行將規則寫入封包過濾器,因此即使防火牆表示連接埠已關閉,單純的 9925:9000 仍可能從外部連線。這個意外行為值得了解一次:請參閱 為什麼已發布的 Docker 連接埠會忽略 ufw。
BASE_URL 必須是你實際使用的確切公開位址,包含 scheme,且結尾不得有斜線。Mealie 會依此建立密碼重設連結與邀請連結。若將它設為 http://localhost:9925,你傳送給伴侶的邀請將包含只能在伺服器本機運作的連結。
啟動服務,並監看第一次啟動過程。
sudo docker compose up -d
sudo docker compose logs -f mealie第一次啟動會建立 SQLite 資料庫並執行 migrations,需等待幾秒。日誌穩定下來、不再顯示 migration 行後,請在本機檢查應用程式。
curl -I http://127.0.0.1:9925出現 200 OK 表示應用程式已啟動。如果看到 Connection refused,請執行 sudo docker compose ps -a 檢查容器狀態與結束代碼。容器以代碼 137 停止表示收到 SIGKILL;但僅憑此代碼,無法判定它超過了 1000M 的記憶體限制。手動終止容器也會產生此代碼。
首次登入與關閉公開註冊
預設帳號是 changeme@example.com,密碼是 MyPassword。請使用這組帳密登入,然後立即變更兩者,因為這組帳密已印在文件中,因此所有掃描工具都知道。
compose 檔中的 ALLOW_SIGNUP: "false" 是刻意這樣設定的。開放註冊時,任何找到該位址的人都能在你的食譜盒中建立帳號。關閉註冊後,請從管理區新增使用者,系統會產生邀請連結,再由你自行傳送給對方。該連結會根據 BASE_URL 建立,因此這項設定值很重要。如果你最後在同一台伺服器上執行多個應用程式,並希望所有應用程式使用同一組密碼,Mealie 可以將登入交由外部身分提供者處理,例如 自行託管的 Authentik 執行個體。
Mealie 會將使用者加入 household,而 household 位於 group 中。同一個 household 的所有人會共用 meal plan 和 shopping list,這符合家庭使用情境。食譜集合的共用範圍更大:同一個 group 中的所有 household 都能共用食譜、標籤與分類。因此,同一台伺服器上的不同 household 會各自保有 meal plan 和 shopping list,但仍會使用同一批食譜;即使是對鯷魚沒有共識的合租者,這種配置仍然適用。如果使用者需要完全分開的集合,請為他們建立不同的 group,因為不同 group 之間不會共用任何資料。
匯入器,這就是執行這項操作的原因
開啟食譜收藏,選擇從 URL 建立食譜,然後貼上連結。Mealie 會擷取該頁面,並尋找結構化食譜資料,也就是多數食譜網站為搜尋引擎嵌入的機器可讀區塊。若頁面包含這個區塊,匯入就能快速且正確地完成。
如果設定了 AI provider,也可以從圖片或貼上的純文字匯入食譜,因此能處理食譜書頁面的照片。圖片匯入需要支援圖片辨識的 provider。未設定 provider 時,無法使用這些匯入方式。這些匯入會經過較慢的處理流程,完成後需要檢查,因為手寫的分數很容易辨識錯誤。
大量匯入也能在同一個畫面執行:貼上一份地址清單,每行一個,Mealie 會在背景逐一處理。一次就能匯入包含 200 個書籤的收藏。
餐點計畫與採購清單
餐點規劃工具是一個行事曆。將食譜拖曳到某一天,即可排入計畫。將已排程的食譜加入採購清單,即可彙整所需食材。若要合併重複項目,請先在 Manage Data 中建立 Foods 和 Units,接著在每份食譜中啟用食材用量,並將食材解析至這些食品與單位。如此一來,兩份食譜都需要洋蔥時,清單會顯示一行,而不是兩行。
這份清單會在購物時以手機上的即時頁面顯示。由於清單由自有伺服器儲存,家中每個人都能同時看到相同內容;其中一人勾選牛奶後,該項目也會從另一人的畫面移除。
將 nginx 與 TLS 置於前端
在此設定中,Mealie 使用純 HTTP;也可透過 TLS_CERTIFICATE_PATH 和 TLS_PRIVATE_KEY_PATH 支援 TLS。在 Mealie 前方的 nginx 中終止傳輸層安全性(TLS)。請先將 DNS A 記錄指向伺服器,因為憑證申請步驟會驗證該名稱。
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
listen 80;
server_name recipes.example.com;
client_max_body_size 64M;
location / {
proxy_pass http://127.0.0.1:9925;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginxnginx -t 顯示 syntax is ok 和 test is successful 是必要檢查。只有檢查通過後才重新載入,因為重新載入錯誤的設定會繼續使用舊設定,直到下次重新啟動前都不會顯現錯誤。
加入 client_max_body_size 64M 是因為 nginx 的預設值為 1 MB。透過瀏覽器上傳食譜照片或還原備份時,要求內容可能超過此大小。若沒有這行,nginx 會回傳 413 Request Entity Too Large,而不是 Mealie,因此應用程式日誌完全不會顯示相關內容。
接著申請憑證。該步驟及其續期計時器詳見使用 certbot 為 nginx 申請 Let's Encrypt 憑證。
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot 會改寫 server block,使其監聽 443,並加入從 80 埠轉址的設定。透過 https:// 載入網站,確認瀏覽器接受該憑證。如果 Mealie 可正常載入,但其中的連結會將你導向 http://,表示 BASE_URL 仍設定為 http。請修正該值,然後執行 sudo docker compose up -d,以新值重新建立容器。
無法將 Mealie 設於 example.com/recipes 這類子路徑下,因為前端無法從子路徑提供服務。請使用子網域。
備份,以及還原實際會做什麼
Mealie 管理的所有資料都位於容器內的 /app/data/,也就是 mealie-data volume。複製此 volume,就能同時複製食譜、圖片與資料庫。Mealie 官方文件指出,停止容器後複製此資料夾,是備份 SQLite 安裝的最佳方式。
sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealievolume 名稱會以專案名稱作為前綴,而專案名稱就是存放 compose 檔案的目錄名稱。在 /srv/mealie 中,volume 為 mealie_mealie-data,因此第一個指令是 docker volume ls:請使用它輸出的名稱,不要使用本指南中的名稱。先停止容器很重要,因為 SQLite 經常正處於寫入狀態,直接複製的內容可能無法還原讀取。
Mealie 也在管理區提供自己的備份頁面,會將資料庫寫入包含 database.json 的 zip 封存檔。此封存檔可還原至執行相同或較新 Mealie 版本的執行個體。若要移轉至其他伺服器,複製 volume 時,請在新伺服器執行相同的固定版本;或將封存檔還原至相同或較新的版本。還原封存檔的設計具有破壞性:它會先刪除目前的資料庫,再載入封存檔,而且無法復原。完成後,你會被登出。
備份檔若仍放在同一台伺服器上,就不能算是備份。請依排程將封存檔推送至其他位置,這正是 使用 restic 進行加密的異地備份 的用途。
更新 Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie提高檔案中的固定版本,然後執行 pull 並重新建立容器。新 image 第一次啟動時會執行資料庫遷移。進行主要版本變更前,請先複製 volume,因為遷移若中途失敗,會留下舊 image 無法再開啟的資料庫。請閱讀目前版本與新版本之間所有版本的發行說明。
匯入失敗時
有些網站完全不發布結構化食譜資料,因此 Mealie 只會匯入標題,成分清單則為空。沒有 AI provider 時,無法透過設定排除這個問題,請改為手動貼上食譜文字。設定 provider 後,若 scraper 找不到資料,Mealie 會將頁面內容交給模型處理;其結果與其他 AI 匯入一樣,都應對照原始內容檢查。
其他失敗原因可能是食譜網站前方的 bot protection。這類機制會回應 challenge page,而不是食譜內容。Mealie 已會模擬瀏覽器並輪替 user agent,以降低這種情況。若網站仍拒絕連線,文件列出的選項包括:讓 scraper 經由具有較佳位址信譽的 proxy,或執行能在實際瀏覽器中解決 challenge 的 FlareSolverr instance。兩者都是選用功能,並且都透過容器上的環境變數設定。
若匯入失敗是因為伺服器完全無法連到該網站,則是另一個問題。請在伺服器上使用 curl -I https://the-site.example/recipe 測試,先讀取 status line,再判斷是否為 scraper 的問題。自 v3.26.0 起,Mealie 也會拒絕從 private 或 internal 位址擷取內容,因此除非將該主機加入 HTTP_ALLOW_LIST 環境變數,否則架設在自有網路上的食譜頁面無法匯入。
適用情境
Mealie 很適合作為家庭第一個自架應用程式,因為同住者不需要別人要求就會使用它。它與使用 Immich 建立自己的相片庫屬於相同類型的工作,但需求輕量許多,也位於更廣泛的 今年值得自架的服務清單中。一台小型伺服器即可同時執行兩者。Immich 並不是第二項工作的唯一選擇;如果你仍在評估,PhotoPrism 與 Immich 的記憶體需求下限和備份指令差異很大,值得先閱讀,再決定要為其他服務保留多少磁碟空間。如果家庭除了晚餐,也想在同一處保存計畫與筆記,自架 AFFiNE 工作區同樣只需處理 compose file,但它需要 4 個容器,所需記憶體也比 Mealie 多得多,因此請先確認伺服器剩餘資源。如果家庭除了晚餐,也想追蹤訓練內容,openGym 會保存訓練內容,並使用你剛完成設定的相同 pinned tag、compose file 與憑證。晚餐後的活動也有相應的選擇:Halcyon 會把現有的 Jellyfin 媒體庫重建成可供你走動瀏覽的 1990 年代出租店。它是在既有服務前方再加入一個小型容器,而不是增加另一個需要備份的資料庫。這類服務不全都是家庭應用程式;如果相同的自架習慣日後也要支援工作用途,自架 Chatwoot 支援服務台同樣需要 pinned tag 與憑證,並在後方搭配 Postgres、Redis 及正常運作的對外寄信功能。這比食譜管理服務重得多,應該使用獨立伺服器。
FAQ
為什麼匯入食譜 URL 會失敗?
常見原因有兩個。第一種是頁面沒有發布結構化食譜資料,因此 scraper 找不到任何內容;除非已設定 AI provider,改由它讀取頁面,否則只會取得標題,不會取得食材。第二種是網站前方的 bot protection layer 回傳 challenge page,而不是食譜內容。針對第二種情況,可以將 Mealie 指向 address reputation 較佳的 proxy,或指向自行託管的 FlareSolverr instance,讓它在實際瀏覽器中解決 challenge。變更任何設定前,先使用 curl -I 確認伺服器確實能連線到該頁面。
我需要 PostgreSQL,還是 SQLite 就足夠?
SQLite 足以供家庭使用,而且是預設選項。當 data directory 位於 network attached storage 時,請改用 PostgreSQL,因為 SQLite 在 network filesystem 上執行會產生 locked-database 錯誤,並可能損毀檔案。使用 PostgreSQL 還原時,database user 必須是 superuser,因為還原程序會先刪除所有內容,再載入 archive。
我可以在沒有網域名稱的情況下執行 Mealie 嗎?
可以,在自己的網路中即可。將 BASE_URL 設為你實際會輸入的位址,例如 http://192.168.1.20:9925;使用伺服器的 LAN 位址,將 port mapping 修改為 192.168.1.20:9925:9000,並略過 nginx。執行 sudo docker compose up -d 以套用這兩項變更。原本的 127.0.0.1:9925:9000 mapping 只接受來自 Docker host 的連線。Invitation 和 password reset 連結是根據 BASE_URL 建立,因此值設定錯誤時,其他人將無法開啟這些連結。請勿透過未加密的 HTTP 將其公開到網際網路,因為登入資訊會以明文傳送。
如何為家人提供各自的登入帳號?
讓 ALLOW_SIGNUP 保持設定為 "false",並從 admin area 新增人員;系統會產生 invitation link,供你傳送給他們。將共用同一個廚房的人員放在相同的 household,讓他們共用 meal plan 和 shopping list。無論如何,群組中的每個 household 都能共用食譜;因此,需要個別收藏集的人員必須分屬不同的 group。
如果我停止執行 Mealie,食譜會怎麼樣?
可以將食譜匯出。管理介面的備份功能會將資料寫入 JSON,Mealie 也能將食譜匯出為 JSON 檔案;即使完全沒有安裝軟體,仍可使用任何文字編輯器讀取這些檔案。請在需要前先執行一次匯出,並確認可以開啟匯出的檔案。