云服务器搭建 ShareLaTeX 备忘录

简要记录一下利用云服务器搭建 Tex Live + ShareLaTeX 的过程

这里用的是以学生优惠价购入的腾讯云服务器(没有打广告,如果有金主爸爸肯提供广告位的话就非常感谢)

Git clone 一下项目

先用 SSH 连接到远程服务器(这里没必要用 PuTTY 之类的,Windows 系统如果已经安装了 OpenSSH 的话直接用终端就行)

1
ssh username@host

然后克隆一下项目:戳我访问 GitHub 项目地址

1
2
git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit
cd ./overleaf-toolkit

接着初始化一下项目(这里用了 Docker 所以务必事先安装 Docker

1
bin/init

配置

然后就可以配置一下你的 ShareLaTeX 了(在 config 这个文件夹里面),主要的配置文件就是 overleaf.rcvariables.env 这两个文件

  • 修改 overleaf.rc 中的 SHARELATEX_LISTEN_IP 这个变量,把它改成你服务器的内网 IP(不是 127.0.0.0,不然你就根本访问不到服务器)
  • 修改 variables.env 中的 SHARELATEX_APP_NAME 这个变量,改成你自己想要的网站名称
  • 如果想要把界面改成中文的话就在 variables.env 中加一行 SHARELATEX_SITE_LANGUAGE=zh-CN
  • 剩下的要个性化的配置,直接看官方 Wiki 就行

ShareLaTeX,启动!

原神,启动!

1
bin/up

然后你就可以输入网址 http://YourHost/launchpad 配置一下管理员账户了

但是,现在如果你想用 TikZ 或者其它什么 LaTeX 包是不行的,因为只是把环境配置完了,相关的软件包还没安装好

先进入 Docker 容器里操作一下:

1
docker exec -it sharelatex bash

第一步,先改一下 sources.list 来加速一下安装过程(什么?没有 Vim?那就先 sudo apt install vim 一下)

1
vim /etc/apt/sources.list

然后改成下面这样子,其它镜像源也是同理

1
2
3
4
5
6
7
8
9
deb http://mirrors.tencentyun.com/ubuntu jammy main restricted
deb http://mirrors.tencentyun.com/ubuntu jammy-updates main restricted
deb http://mirrors.tencentyun.com/ubuntu jammy universe
deb http://mirrors.tencentyun.com/ubuntu jammy-updates universe
deb http://mirrors.tencentyun.com/ubuntu jammy multiverse
deb http://mirrors.tencentyun.com/ubuntu jammy-updates multiverse
deb http://mirrors.tencentyun.com/ubuntu jammy-security main restricted
deb http://mirrors.tencentyun.com/ubuntu jammy-security universe
deb http://mirrors.tencentyun.com/ubuntu jammy-security multiverse

国内由于众所周知的原因,CTAN 特别特别特别慢,所以这里给 CTAN 也换个源:

1
tlmgr option repository http://mirrors.tencentyun.com/CTAN/systems/texlive/tlnet

现在就可以安装 LaTeX 包了,嫌麻烦的话就直接安装所有的包:

1
2
tlmgr install scheme-full
tlmgr update --self --all

这时候还没结束,我们还需要安装好 Tex Live 的一些额外的包(特别是中文支持等等),这里同样地,嫌麻烦直接安装所有包:

1
sudo apt install texlive-full

BTW:如果不需要那么多东西的话安装下面这些也行:

1
sudo apt install texlive-latex-base texlive-latex-extra texlive-latex-recommended texlive-fonts-recommended texlive-lang-chinese texlive-xetex

现在已经全部完成安装了,赶紧愉快的玩耍吧~

1
2
exit
docker restart sharelatex

我已经搭建完成的网站:Ryker Zhu LaTeX Editor

Minted 代码高亮部署

(2023/9/9 更新,参考资料点我) 虽然前面几步已经完成了 ShareLaTeX 的部署,但是如果使用了 minted 这个宏包还是会报错,这是因为默认的 Docker 容器内并没有安装 Pygment 环境(提供语法解析器功能)。

  1. 安装 Python 和 Pygments

    1
    2
    apt install python3
    apt install python-pygments
  2. 配置 Shell Escape

    修改容器内的 /usr/local/texlive/(版本)/texmf.cnf,在最低行添加

    1
    shell_escape = t

    然后重启一下 sharelatex 这个 Docker 容器


云服务器搭建 ShareLaTeX 备忘录
https://devexzh.github.io/2023/Memo_Of_Deploying_ShareLaTeX_On_Remote_Server/
作者
Ryker Zhu
发布于
2023年8月11日
许可协议