开放原子开发者工作坊

Overleaf简介

overleaf是一个在线latax写论文的神器，不用配置本地环境，浏览器访问即可实时编译，而且其提供多人协作功能，但是官网具有诸多限制，例如空间等，且安全性等因素不能保证，所幸其已在github进行开源，我们可以在自己的服务器通过docker进行部署。

Docker安装

有关docker的入门可以参考 阮一峰先生的博文 。这里笔者参考 docker官网安装教程 尝试了在ubuntu 18,ubuntu 20,macos上进行了分别部署，均未遇到坑，在此不再赘述。

可以通过以下命令查看是否安装成功：

docker version

Overleaf安装

• 1.

  拉取最新的overleaf服务器版本

  docker pull sharelatex/sharelatex

• 2.

  在用户目录~下，新建以下文件夹

  mkdir ~/sharelatex/ ~/sharelatex/sharelatex_data/ ~/sharelatex/mongo_data/ ~/sharelatex/redis_data/

• 3.

  下载docker-compose.yml文件到~/sharelatex/文件夹下

  curl -O https://raw.githubusercontent.com/sharelatex/sharelatex/master/docker-compose.yml

• 4.

  修改docker-compose.yml配置文件

  # 避免端口重复,默认80端口，但是笔者的80端口开放给了apache，因此这里修改为5000

  # 端口号:80

  ports:

  - 5000:80

  # 修改本地挂载目录

  volumes:

  ~/sharelatex/sharelatex_data:/var/lib/sharelatex

  # 添加升级texlive需要的环境变量，主要是添加2018目录到2017前面，目的是为了防止后面安装完整版texlive时出现错误

  # 【这里原博主有写，但是我添加以后好像并没有什么效果，不添加也是可以的】

  environment:

  - PATH: /usr/localsbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/texlive/2018/bin/x86_64-linux:/usr/local/texlive/2017/bin/x86_64-linux

  # 下面选项设置ShareLaTeX的显示样式

  SHARELATEX_APP_NAME: Our ShareLaTeX

  SHARELATEX_NAV_TITLE: Our ShareLaTeX Instance

  SHARELATEX_HEADER_IMAGE_URL: http://somewhere.com/mylogo.png

  SHARELATEX_LEFT_FOOTER: '[{"text": "Powered by <a href=\"https://www.sharelatex.com\">ShareLaTeX</a> 2016"},{"text": "Another page I want to link to can be found <a href=\"here\">here</a>"} ]'

  SHARELATEX_RIGHT_FOOTER: '[{"text": "Hello I am on the Right"} ]'

  # 修改mongo和redis的本地挂载目录

  # mongo

  volumes:

  ~/sharelatex/mongo_data:/data/db

  # redis

  volumes:

  ~/sharelatex/redis_data:/data

  这里附上我的 docker-compose.yml文件

• 5.

  进入~/sharelatex启动docker-compose.yml

  docker-compose up -d

• 6.

  由于默认安装的是最小版本 TeXLive，如果要安装完整包，执行

  docker exec sharelatex tlmgr install scheme-full

• 7.

  第一次启动镜像后，浏览器访问 localhost:port/launchpad 页面设置管理员账号

• 8.

  客户机可以在浏览器通过ip:port访问