腳本之家服務(wù)器常用軟件

快捷導(dǎo)航

Docker本地部署Overleaf的實(shí)現(xiàn)步驟

更新時(shí)間：2025年05月15日 09:57:26 作者：小鋒學(xué)長生活大爆炸

本文主要介紹了Docker本地部署Overleaf的實(shí)現(xiàn),包括克隆倉庫、初始化配置、修改配置文件、啟動(dòng)服務(wù)和創(chuàng)建管理員賬戶等步驟,具有一定的參考價(jià)值,感興趣的可以了解一下

背景說明

Overleaf又掛了，數(shù)據(jù)放在別人手里真是不靠譜。反正Overleaf是開源的，所以自己搭建一個(gè)。

Overleaf Status

教程來自官方：toolkit/doc/quick-start-guide.md at master · overleaf/toolkit · GitHub

下載倉庫

首先，讓我們將這個(gè)git存儲庫克隆到你的機(jī)器上：

git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit

接下來讓我們進(jìn)入這個(gè)目錄：

cd ./overleaf-toolkit

讓我們看一下存儲庫的結(jié)構(gòu)：

ls -l

它將打印如下內(nèi)容：

bin
CHANGELOG.md
config
data
doc
lib
LICENSE
README.md

該README.md文件包含一些關(guān)于項(xiàng)目的有用信息
doc目錄包含使用該工具包所需的所有留檔
config目錄將包含本地配置文件（我們稍后將創(chuàng)建）
bin目錄包含管理背面實(shí)例的腳本集合

初始化配置

讓我們通過運(yùn)行bin/init來創(chuàng)建本地配置：

bin/init

現(xiàn)在檢查config/目錄的內(nèi)容

ls config
# overleaf.rc     variables.env     version

這是將與之交互的三個(gè)配置文件：

overleaf.rc：主要的頂級配置文件
variables.env：加載到docker容器中的環(huán)境變量
version：要使用的docker映像的版本

默認(rèn)情況下，工具包使用免費(fèi)的社區(qū)版
默認(rèn)情況下，overleaf使用texlive，并且宏包是不全的

修改監(jiān)聽IP和端口

在./config/overleaf.rc中，需要修改以下字段：

OVERLEAF_LISTEN_IP=0.0.0.0 # 監(jiān)聽所有的IP
OVERLEAF_PORT=8000         # 默認(rèn)是80端口

自定義網(wǎng)站名稱

在./config/variables.env文件中，修改：

OVERLEAF_APP_NAME="Overleaf Instance"
OVERLEAF_SITE_URL=xxx
OVERLEAF_NAV_TITLE="Overleaf Instance"
OVERLEAF_ADMIN_EMAIL=mail@xxx.site

修改完配置文件之后，需要重新build才可以應(yīng)用配置。

sudo bin/down 
sudo bin/up

修改Mongo版本

MongoDB 官方從 5.0 開始引入的硬件限制，強(qiáng)制要求支持 AVX，無法通過任何軟件方法繞過。所以需要降低版本。

在./config/overleaf.rc中，需要修改以下字段：

MONGO_VERSION=4.4

修改數(shù)據(jù)存放位置

在./config/overleaf.rc中，需要修改以下字段：

更換Docker源

可以看這篇：【教程】最新可用！Docker國內(nèi)鏡像源列表

推薦：https://docker.1panel.live

更換Docker存儲位置

可以看這篇：【教程】Docker更換存儲位置

啟動(dòng)Overleaf

該工具包使用docker compose來管理docker容器。該工具包提供了一組腳本來包裝docker compose，并處理大部分細(xì)節(jié)。

可以先檢查一下是否存在隱性問題：

sudo bin/doctor

然后讓我們啟動(dòng)docker服務(wù)：

sudo bin/up

# 后臺運(yùn)行：
# sudo bin/up -d

應(yīng)該看到docker容器的一些日志輸出，表明容器正在運(yùn)行。如果在終端按CTRL-C，服務(wù)將關(guān)閉。可以通過運(yùn)行bin/start再次啟動(dòng)它們（而不附加到日志輸出）。更一般地說，如果發(fā)現(xiàn)腳本沒有涵蓋你的用例，可以運(yùn)行bin/docker-compose來直接控制docker compose系統(tǒng)。

創(chuàng)建管理員帳戶

在瀏覽器中，打開http://localhost/launchpad。應(yīng)該會看到一個(gè)包含電子郵件和密碼字段的表單。用想用作管理員帳戶的憑據(jù)填寫這些憑據(jù)，然后單擊“注冊”。
然后單擊鏈接進(jìn)入登錄頁面（http://localhost/login）。輸入憑據(jù)。登錄后，將被帶到歡迎頁面。
單擊頁面底部的綠色按鈕開始使用。