Jerry's Blog
Jerry's Blog/
🕞
本地搭建sharelatex协作服务器
Search
本地搭建sharelatex协作服务器
🕞

本地搭建sharelatex协作服务器

Tags
Latex

为什么要本地搭建sharelatex协作web应用

有一个网站，叫做overleaf，是一个非常好用的latex在线编辑网站，集协作、聊天、latex代码补全等多种功能为一体的latex写作网站，最重要的是，debug比较容易，出现小错误也会强制编译成功，非常适合新手。然而，这个网站的服务器在国外，网络连接不太稳定，科学上网也常常会出现连接中断的情况，很烦。一次偶然的情况下，我发现overleaf居然在github上开源了，而且还可以用docker一键本地部署，于是开始操作起来。

安装docker-ce

dokcer-ce是较新版本的docker，而且是社区版。我的使用的系统是的deepin15.11，也许由于某些问题（我太菜了），我无法正常使用mongo，因此我在使用VMware创建了一个ubuntu server 18.04，在此server上安装docker-ce。
卸载老版本
sudo apt-get remove docker docker-engine docker.io
从apt源安装
sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
sudo apt-get update
sudo apt-get install docker-ce
安装好了之后，验证是否安装成功。
sudo docker -v
notion image
UTOOLS1586352347164.png
这表示安装成功，版本为19.03.8。因为我是在一个单独的虚拟机上跑docker，而且这个虚拟机只跑某一个服务，因此我没有设置docker用户组，直接用sudo权限运行docker。要想设置普通用户使用docker，参见
【Docker】非root用户加入docker用户组省去sudo （三）

安装docker-compose

这是一个协同多个docker容器的工具，而且可以更加容易的设置环境变量。
输入以下代码安装docker-compose 1.25.4（速度较慢）
curl -L https://github.com/docker/compose/releases/download/1.25.4/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
输入以下命令
docker-compose -v
出现以下信息则表示安装成功
notion image
UTOOLS1586352886310.png

pull images

sharelatex官方的image是不包括完整的textlive的，需要自行安装完整版，这里我找到了其他开发者已经集成texlive-2019完整版的sharelatex，依次输入以下命令
sudo docker pull mongo
sudo docker pull redis
sudo docker pull flodointhecloud/sharelatex-texlive2019
完整版texlive的镜像大约9G多，pull下载需要一段时间，国内速度太慢可以选择使用镜像站点，参见
docker 设置国内镜像源_whatday的专栏-CSDN博客_docker 镜像
创建或修改 /etc/docker/daemon.json 文件，修改为如下形式 # vi /etc/docker/daemon.json { "registry-mirrors": ["http://hub-mirror.c.163.com"] } systemctl restart docker.service 国内加速地址有： Docker中国区官方镜像 https://registry.docker-cn.com 网易 http://hub-mirror.c.163.com ustc https://docker.mirrors.ustc.edu.cn 中国科技大学 https://docker.mirrors.ustc.edu.cn 阿里云容器 服务 https://cr.console.aliyun.com/ 首页点击"创建我的容器镜像" 得到一个专属的镜像加速地址，类似于"https://1234abcd.mirror.aliyuncs.com"
docker 设置国内镜像源_whatday的专栏-CSDN博客_docker 镜像
https://blog.csdn.net/whatday/article/details/86770609
docker 设置国内镜像源_whatday的专栏-CSDN博客_docker 镜像

下载docker-compose.yml文件

overleaf在github上提供了构建sharelatex的yml文件，下载即可链接 （可能打不开，可以自定义域名解析，详见百度）
下载好后修改以下内容
  1. container_name改为flodointhecloud/sharelatex-texlive2019

运行sharelatex

进入docker-compose.yml所在的目录，输入以下命令
sudo docker-compose up
稍等片刻，就启动成功了。
VMware设置桥接网络，输入虚拟机的ip地址即可进入sharelatex的主页，我这里是http://192.168.1.8/
notion image
UTOOLS1586354080411.png
输入http://192.168.1.8/launchpad设置第一个管理员，设置完成后输入你的设置信息即可登录成功。
notion image
UTOOLS1586354054553.png

更多个性化设置

  1. 设置环境变量：详见overleaf官方wiki
      2. 特别的，设置
      SHARELATEX_SITE_LANGUAGE : cn
      即可把语言切换成中文
  1. 通过内网穿透将其放在公网访问

参考文献

ubuntu 18.04 安装docker ce
docker-compose releases页面