服务器 on kellehod的博客

overleaf自部署

Sat, 11 Oct 2025 16:19:36 +0800

声明

这篇文章是由cc + glm 辅助生成的

前置要求

服务器已安装Docker和Docker Compose
具备基本的Linux命令操作能力
拥有一个邮箱账户用于邮件服务配置

镜像下载

Overleaf主镜像

推荐使用增强版Overleaf镜像，包含了完整的TeX Live环境：

1
2

# 国内用户可使用镜像加速
docker pull docker.1ms.run/tuetenk0pp/sharelatex-full

增强功能包括：

完整的TeX Live安装及所有可用包
支持minted代码高亮
支持SVG图片（集成Inkscape）
支持Lilypond音乐排版
默认启用shell-escape

数据库镜像下载

MongoDB配置

# 下载MongoDB 6.0
docker pull docker.1ms.run/library/mongo:6.0

# 重命名镜像
docker tag docker.1ms.run/library/mongo:6.0 mongo:6.0
docker rmi docker.1ms.run/library/mongo:6.0

Redis配置

# 下载Redis 6.2
docker pull docker.1ms.run/library/redis:6.2

# 重命名镜像
docker tag docker.1ms.run/library/redis:6.2 redis:6.2
docker rmi docker.1ms.run/library/redis:6.2

项目配置

下载部署工具

1
2

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

生成配置文件

`1`	`bin/init`

替换镜像

编辑overleaf-toolkit/lib/docker-compose.base.yml, 注意，这个镜像为刚才下载的那个overleaf主镜像，如果你是使用docker.1ms.run下载的，image改为docker.1ms.run/tuetenk0pp/sharelatex-full

`1`	`image: "${IMAGE}" --> image: tuetenk0pp/sharelatex-full`

基础配置文件编辑

编辑 config/overleaf.rc：

# 修改监听地址
OVERLEAF_LISTEN_IP=127.0.0.1 --> OVERLEAF_LISTEN_IP=0.0.0.0
# 设置容器映射的端口 OVERLEAF_PORT:80
OVERLEAF_PORT=8108

# 注释掉Nginx
# TLS proxy configuration (optional)
# See documentation in doc/tls-proxy.md
NGINX_ENABLED=false
# NGINX_CONFIG_PATH=config/nginx/nginx.conf
# NGINX_HTTP_PORT=80
# Replace these IP addresses with the external IP address of your host
# NGINX_HTTP_LISTEN_IP=127.0.1.1
# NGINX_TLS_LISTEN_IP=127.0.1.1
# TLS_PRIVATE_KEY_PATH=config/nginx/certs/overleaf_key.pem
# TLS_CERTIFICATE_PATH=config/nginx/certs/overleaf_certificate.pem
# TLS_PORT=443

环境变量配置

编辑 config/variables.env：

# 实例基本信息
OVERLEAF_APP_NAME=My Overleaf Instance
OVERLEAF_SITE_URL=http://your-server-ip:port
OVERLEAF_NAV_TITLE=My Overleaf

# 管理员邮箱配置
OVERLEAF_ADMIN_EMAIL=admin@yourdomain.com
OVERLEAF_EMAIL_FROM_ADDRESS=noreply@yourdomain.com

# SMTP邮件服务配置（以163邮箱为例）
OVERLEAF_EMAIL_SMTP_HOST=smtp.163.com
OVERLEAF_EMAIL_SMTP_PORT=465
OVERLEAF_EMAIL_SMTP_SECURE=true
OVERLEAF_EMAIL_SMTP_NAME=Overleaf
OVERLEAF_EMAIL_SMTP_USER=your-email@163.com
OVERLEAF_EMAIL_SMTP_PASS=your-smtp-password

# 页脚自定义
OVERLEAF_LEFT_FOOTER='[{"text": "Contact Support", "url": "mailto:support@yourdomain.com"}]'
OVERLEAF_RIGHT_FOOTER='[{"text": "© 2025 Your Company"}]'

# TLS配置（重要：无证书时必须配置，否则邮件发不出）
OVERLEAF_EMAIL_SMTP_TLS_REJECT_UNAUTH=false
OVERLEAF_EMAIL_SMTP_IGNORE_TLS=true

部署步骤

初始化配置

# 启动所有服务
bin/up
# 可以后台启动
bin/up -d

验证部署

访问 http://your-server-ip:port，应该能看到Overleaf登录页面。

创建管理员账户

访问http://your-server-ip:port/launchpad，进行管理员账户注册

或者, 进入容器内设置

1
2
3

docker exec -it sharelatex /bin/bash
cd /overleaf/services/web
grunt user:create-admin --email=admin@example.com

升级成员为管理员

直接操作MongoDB数据库

docker exec -it mongo mongosh
切换数据库， use sharelatex
查找所有用户，db.users.find({}, {email:1, isAdmin:1})
将目标用户设置为管理员，db.users.updateOne({email: “you@example.com”}, {$set: {isAdmin: true}})
退出，exit

参考资源

GitLab Runner 以 Docker 容器方式部署

Sat, 09 Aug 2025 15:38:37 +0800

1、问题背景

GitLab Runner 跑在一个容器里
用 shell 执行器
容器里shell执行器运行 docker compose 来启动服务
依赖宿主机 Docker（docker:dind）去创建业务容器

在启动服务时，docker compose 涉及文件挂载。相关文件最初由宿主机挂载到 Runner 容器中，然后在 docker-compose.yml 中再次挂载到业务容器。
在宿主机直接执行 docker compose 启动服务一切正常，但在 Runner 容器中执行时，就会报以下错误。

2、报错

Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error mounting "/home/xxx/client/conf/nginx.conf" to rootfs at "/etc/nginx/nginx.conf": create mountpoint for /etc/nginx/nginx.conf mount: cannot create subdirectories in "/var/lib/docker/overlay2/be07c226551b939ab5c47865c441c289bba7f26e7a449ef8610f5399e7ec2fda/merged/etc/nginx/nginx.conf": not a directory: unknown: Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type

3、chatgpt给的方案

方案 1：路径一致化

确保 Runner 容器挂载的路径 和 宿主机路径 完全一致。

比如宿主机上有：

`1`	`/srv/ci-data/nginx.conf`

启动 Runner 容器时：

`1`	`docker run -v /srv/ci-data:/srv/ci-data gitlab-runner`

那么 docker-compose.yml 里用：

1
2

volumes:
  - /srv/ci-data/nginx.conf:/etc/nginx/nginx.conf:ro

这样 Docker daemon 解析路径时就能找到正确的文件。

方案 2：把文件做成 Volume

不要直接 bind-mount 宿主机路径，而是：

1
2

docker volume create nginx_conf
docker run -v nginx_conf:/etc/nginx ...

这样路径类型和内容不会依赖宿主机真实文件结构，避免类型冲突。但缺点是调试不如 bind mount 方便。

4、解决

通过使用方案1成功解决了如上问题。

另外一个小办法

在docker-compose.yml中先不挂载
docker compose起了服务后，通过命令拷贝到对应的业务容器，然后重启业务

示例原先的挂载

volumes:
      - "$PWD/conf/nginx.conf:/etc/nginx/nginx.conf"
      - "$PWD/conf/xxx.pem:/etc/nginx/xxx.pem"
      - "$PWD/conf/xxx.key:/etc/nginx/xxx.key"

删除这部分挂载，直接docker compose启动，然后拷贝

docker cp ./conf/nginx.conf <container_name>:/etc/nginx/nginx.conf
docker cp ./conf/xxx.pem <container_name>:/etc/nginx/xxx.pem
docker cp ./conf/xxx.key <container_name>:/etc/nginx/xxx.key
docker exec <container_name> nginx -s reload