欢迎您访问 最编程 本站为您分享编程语言代码,编程技术文章!
您现在的位置是: 首页

在阿里云ECS上设置并运行Overleaf的步骤

最编程 2024-08-10 19:10:41
...

简介

通过同学推荐,我了解到阿里云为学生提供了免费的算力资源,正好我需要部署一个Overleaf实例给我自己使用,所以我选择了阿里云。


Overleaf是一个在线的LaTeX编辑器,它支持多人协作,无需在本地进行任何配置即可编写LaTeX文档,同时支持版本管理(企业版),数据同步。Overleaf官方开源了社区版的Overleaf,允许个人用户在自己的服务器上部署Overleaf。


在2020年,Overleaf官方又发布了官方的Overleaf配置工具Overleaf-ToolKit,即使是不了解Docker的小白也能通过里面的指引很快部署Overleaf。


本文使用阿里云ECS提供的Ubuntu 20.04,部署Overleaf实例,和Overleaf官方网站相比,这个搭建在国内服务器的实例速度更快,也不容易掉线。

更新apt源

只需要在命令行输入apt update就可以更新软件源。让我惊喜的是,阿里云已经自动将apt源配置为阿里云镜像,省去了我配置的麻烦。

安装Docker和Docker-Compose

Docker 是一个开源的应用容器引擎,基于 Go 语言 并遵从 Apache2.0 协议开源。

Docker 可以让开发者打包他们的应用以及依赖包到一个轻量级、可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。


Docker官方提供了在服务器上快速安装Docker的脚本,首先使用这个脚本安装Docker。

curl -fsSL https://get.docker.com -o get-docker.sh
sh ./get-docker.sh

Docker的安装需要一点时间,在安装完成后,再从apt源中安装docker-compose:

apt install docker-compose

至此Overleaf需要的依赖环境就已经配置好了,下面通过Overleaf-ToolKit配置Overleaf。

拉取Overleaf-ToolKit

首先,通过ssh或WorkBench连接到自己的阿里云ECS实例,并运行以下命令,安装git:

apt install -y git

等待git安装完成,从Overleaf-ToolKit的官方Github仓库克隆相关工具:

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

在命令行输入cd overleaf切换到刚才的目录,使用ls命令查看里面的内容。

网络异常,图片无法展示
|


配置Overleaf

克隆下来的overleaf文件夹中有几个文件夹,其中bin文件夹存放启动、停止、配置Overleaf的脚本,doc文件夹中有配置Overleaf相关操作的指引。

第一次运行时,需要首先运行配置脚本。在终端切换到overleaf/bin文件夹,输入./init,程序会自动创建config文件夹中的配置。

一开始,config文件夹中包含了三个文件:overleaf.rc、variables.env、version,其中overleaf.rc是overleaf的核心配置文件,因为服务器默认只监听本地端口,所以需要进行修改。打开overleaf.rc,将SHARELATEX_LISTEN_IP修改为0.0.0.0。在有需要的情况下,可以修改端口号。

网络异常,图片无法展示
|

与此同时,我们还需要在阿里云控制台上,修改实例的安全组,允许指定的端口号通过。我这里偷懒,将安全组允许所有TCP链接入站。

网络异常,图片无法展示
|

在这一切都配置结束后,切换到overleaf/bin文件夹下,输入./up,第一次运行时会自动拉取需要的Docker镜像。当一切就绪后,在浏览器输入<你的服务器地址>/launchpad就可以进入overleaf控制台,按照提示即可创建管理员账号,登录这个账号,就可以开始编写LaTeX文件了。


安装完整版本的TeXLive

Overleaf自带的TexLive只有最小功能,不能编写中文文档,很多宏包缺失。在安装完成后,还需要安装完整版本的TeXLive。

网络异常,图片无法展示
|


在bin文件夹下,overleaf已经给我们提供了快速进入overleaf镜像终端的工具,只需要运行./shell就可以进入overleaf镜像。

因为镜像自带的TeXLive版本为2021,而最新版是2022,需要首先配置软件源为旧软件源,否则无法进行安装,我选择了使用清华镜像源。

在终端输入以下命令:

tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/tex-historic-archive/systems/texlive/2021/tlnet-final/

设置完成后使用tlmgr install scheme-full就可以安装所有包了,整个安装过程大约40分钟,将会安装四千多个宏包,在这个过程中,尽量不要关闭终端。

安装完成后,整个Overleaf的功能就全部可用了。

推荐阅读