# Overleaf搭建

## Overleaf简介

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

## Docker安装

有关docker的入门可以参考[阮一峰先生的博文](http://www.ruanyifeng.com/blog/2018/02/docker-tutorial.html)。这里笔者参考[docker官网安装教程](https://docs.docker.com/engine/install/)尝试了在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文件](https://app.gitbook.com/s/-M8EdP159RyjUv9qUZIH/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访问