Crater 容器化部署指南用 Docker Compose 本地部署再到生產(chǎn)環(huán)境平滑擴(kuò)展【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/craterCrater 是一款開源的發(fā)票管理系統(tǒng)覆蓋客戶管理、報價單、發(fā)票、付款記錄和費(fèi)用追蹤適合自由職業(yè)者、小團(tuán)隊(duì)以及需要給客戶開具正式發(fā)票的企業(yè)。這篇文章給你一條完整的落地路徑如何用 Docker Compose 在本地把 Crater 跑起來怎么確認(rèn)服務(wù)真的可用以及當(dāng)你需要面對多副本、持久化存儲和外部訪問時生產(chǎn)環(huán)境該如何設(shè)計(jì)。全文只講關(guān)鍵步驟先跑通再優(yōu)化。部署前先確認(rèn)三件事環(huán)境與端口是否就緒Docker 與 Docker Compose 已安裝并可正常構(gòu)建鏡像主機(jī) 80 端口未被占用Nginx 容器映射到80:80主機(jī) 3306 被占用也沒關(guān)系編排文件里數(shù)據(jù)庫對外暴露的是33006:3306目錄與文件是否完整從 gitcode 倉庫克隆完整項(xiàng)目后確認(rèn)以下文件都在根目錄中缺任何一個部署都會中斷git clone https://gitcode.com/gh_mirrors/cr/crater cd crater需要重點(diǎn)確認(rèn)的三個位置docker-compose.yml服務(wù)編排定義包含 app、db、nginx、cron 四個服務(wù)Dockerfile基于php:8.1-fpm的應(yīng)用鏡像構(gòu)建文件docker-compose/setup.sh容器啟動后的初始化腳本數(shù)據(jù)庫連接信息編排文件中 MariaDB 的默認(rèn)賬號密碼均為craterMYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE并且數(shù)據(jù)庫數(shù)據(jù)掛載在名為db的命名卷里。如果你要改成把數(shù)據(jù)落到宿主機(jī)目錄需要注釋掉db:/var/lib/mysql那一行啟用下面注釋掉的宿主機(jī)路徑掛載并按自己的需求修改環(huán)境變量。最短路徑三步把服務(wù)跑起來第一步構(gòu)建并啟動容器docker-compose up -d --build這條命令會構(gòu)建 PHP 應(yīng)用鏡像和 cron 鏡像然后拉起四個服務(wù)NginxWeb 入口、PHP-FPM應(yīng)用進(jìn)程、MariaDB數(shù)據(jù)庫、cronLaravel 定時任務(wù)調(diào)度。第二步執(zhí)行初始化腳本容器起來不等于應(yīng)用可用。Crater 需要在容器內(nèi)完成依賴安裝、密鑰生成和存儲軟鏈接項(xiàng)目自帶的初始化腳本已經(jīng)封裝好這些操作sh docker-compose/setup.sh腳本內(nèi)部執(zhí)行了三件事composer install安裝 PHP 依賴、php artisan storage:link建立storage軟鏈、php artisan key:generate生成應(yīng)用密鑰。注意第二條命令帶了|| true也就是說軟鏈?zhǔn)〔粫钄嗔鞒獭绻惭b向?qū)Ю锍霈F(xiàn)靜態(tài)資源 404回頭檢查這一步的日志。第三步打開瀏覽器訪問http://localhost看到 Crater 的安裝向?qū)Ъ幢硎?Web 鏈路已通。安裝向?qū)龑?dǎo)你完成公司信息和管理員賬號設(shè)置。上圖為 Crater 生成的發(fā)票樣式系統(tǒng)支持自定義模板與多幣種結(jié)算安裝完成后你可以在后臺直接編輯發(fā)票外觀。啟動后如何驗(yàn)證服務(wù)正常先驗(yàn)證再談配置。建議按下面順序逐項(xiàng)確認(rèn)任何一項(xiàng)不通過就先停下排查不要繼續(xù)往下走。檢查安裝向?qū)c頁面資源首頁能打開安裝向?qū)дｄ秩卷撁鏄邮?、圖標(biāo)不缺失。樣式文件缺失通常指向composer install未執(zhí)行或構(gòu)建產(chǎn)物未完成能進(jìn)入數(shù)據(jù)庫配置步驟說明 PHP 到 MariaDB 的鏈路是通的檢查定時任務(wù)是否在工作Crater 的發(fā)票狀態(tài)流轉(zhuǎn)如過期提醒、逾期標(biāo)記依賴schedule:run容器里由 cron 服務(wù)每分鐘執(zhí)行一次?？梢杂眠@條命令觀察輸出docker-compose logs cron日志持續(xù)滾動且無報錯說明調(diào)度器正常。如果這個容器沒起來定時任務(wù)全部失效屬于隱蔽故障值得單獨(dú)留意。檢查數(shù)據(jù)庫持久化重啟容器后登錄 MariaDB 確認(rèn)數(shù)據(jù)仍在docker-compose exec db mysql -u crater -pcrater crater -e show tables;表結(jié)構(gòu)存在、重啟不丟數(shù)據(jù)持久化才算真正生效。關(guān)鍵配置項(xiàng)說明上傳體積限制上傳收據(jù)、客戶頭像等文件時有兩個限制要同時看docker-compose/php/uploads.iniPHP 側(cè)的upload_max_filesize與post_max_size默認(rèn) 64Mdocker-compose/nginx/nginx.confNginx 側(cè)的client_max_body_size默認(rèn) 64M兩邊取較小值生效。需要調(diào)大時兩處都要改只改一處會留下隱蔽的上傳失敗問題。應(yīng)用運(yùn)行參數(shù)Laravel 應(yīng)用的APP_URL、數(shù)據(jù)庫主機(jī)等配置在安裝向?qū)Щ?env中維護(hù)。容器網(wǎng)絡(luò)里應(yīng)用連接數(shù)據(jù)庫的主機(jī)名是db而不是localhost——這是容器化部署中最高頻的踩坑點(diǎn)之一改配置時先確認(rèn)自己是在容器網(wǎng)絡(luò)還是宿主機(jī)視角下填寫。文件掛載策略編排文件把整個項(xiàng)目目錄掛載到容器內(nèi)的/var/www意味著你本地修改代碼后容器即時生效適合開發(fā)調(diào)試。生產(chǎn)環(huán)境建議改用只讀掛載或干脆把構(gòu)建產(chǎn)物打進(jìn)鏡像避免運(yùn)行時目錄被隨意改寫。從單機(jī)到生產(chǎn)的擴(kuò)展思路不要一上來直接上生產(chǎn)。先用 Docker Compose 在測試環(huán)境完整跑一遍安裝、發(fā)發(fā)票、付款、備份全流程再考慮編排平臺。鏡像化與副本數(shù)把Dockerfile構(gòu)建的crater-php鏡像推送到內(nèi)部鏡像倉庫然后在 Kubernetes 中創(chuàng)建 Deployment 時應(yīng)用容器只保留 PHP-FPM 或改用 Nginx 內(nèi)置鏡像作為對外入口Web 層無狀態(tài)后可以放心設(shè)多個副本storage目錄的寫入需要規(guī)劃清楚會話、上傳文件落在哪個存儲介質(zhì)上多副本下ReadWriteOnce的 PVC 無法被多個 Pod 共享通常需要共享存儲或?qū)ο蟠鎯Ψ桨缚山Y(jié)合項(xiàng)目實(shí)際配置確認(rèn)外部訪問與配置管理用 Ingress 暴露服務(wù)配好域名與 TLS數(shù)據(jù)庫建議改用集群內(nèi)獨(dú)立數(shù)據(jù)庫實(shí)例不要和業(yè)務(wù) Pod 共用節(jié)點(diǎn)APP_KEY、數(shù)據(jù)庫口令這類敏感值放入 Secret常規(guī)參數(shù)放入 ConfigMap不要寫死在清單里定時任務(wù)的生產(chǎn)化單機(jī)方案的 cron 容器在生產(chǎn)中應(yīng)替換為 Kubernetes CronJob保證schedule:run全局只有一個調(diào)度入口避免重復(fù)執(zhí)行。常見問題排查清單現(xiàn)象優(yōu)先檢查點(diǎn)頁面 502 或一直加載docker-compose ps看 app 是否 runningdocker-compose logs app查 PHP 錯誤安裝向?qū)Эㄔ跀?shù)據(jù)庫步驟確認(rèn)連接主機(jī)填的是db確認(rèn) MariaDB 容器已 ready樣式錯亂、圖標(biāo) 404重新執(zhí)行docker-compose exec app php artisan storage:link確認(rèn)composer install成功文件上傳報 size 錯誤同時核對uploads.ini與nginx.conf里的 64M 限制重啟后數(shù)據(jù)沒了確認(rèn)db命名卷存在或宿主機(jī)掛載路徑寫對到期發(fā)票狀態(tài)不自動變化檢查 cron 容器日志確認(rèn)schedule:run在跑排查順序建議先看容器狀態(tài)docker-compose ps再看容器日志docker-compose logs 服務(wù)名最后才進(jìn)容器內(nèi)部docker-compose exec app手動執(zhí)行命令復(fù)現(xiàn)。部署選型建議個人使用或開發(fā)調(diào)試Docker Compose 一鍵啟動即可本項(xiàng)目自帶的編排文件已經(jīng)覆蓋了 Web、數(shù)據(jù)庫和定時任務(wù)沒有多余復(fù)雜度小團(tuán)隊(duì)生產(chǎn)Docker Compose 定期docker compose pull更新 獨(dú)立的數(shù)據(jù)庫備份腳本成本最低企業(yè)級多副本遷移到 Kubernetes重點(diǎn)解決存儲共享、Secret 管理和 CronJob 化三件事一個務(wù)實(shí)的順序是本地 Compose 跑通 → 測試環(huán)境驗(yàn)證完整業(yè)務(wù)流 → 再上編排平臺。Crater 的容器化入口就在倉庫根目錄的docker-compose.yml配合 docker-compose 配置目錄 中的 Nginx、PHP 與 cron 文件足以覆蓋大多數(shù)場景不必一開始就追求最復(fù)雜的架構(gòu)。【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/crater創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考