基本问题
Q01:Ayakaleaf Pro 是免费试用版吗?需要许可证吗?
Q01:Ayakaleaf Pro 是免费试用版吗?需要许可证吗?
Q02:Ayakaleaf Pro 是否包含 Overleaf Server Pro 的所有功能?
Q02:Ayakaleaf Pro 是否包含 Overleaf Server Pro 的所有功能?
Q03:Overleaf Server Pro 的价格是多少?
Q03:Overleaf Server Pro 的价格是多少?
Q04:为什么 Overleaf Server Pro 不包含 GitHub 同步或 AI 功能?
Q04:为什么 Overleaf Server Pro 不包含 GitHub 同步或 AI 功能?
Q05:Ayakaleaf Pro 安全可靠吗?
Q05:Ayakaleaf Pro 安全可靠吗?
Q06:Ayakaleaf Pro 会长期维护吗?
Q06:Ayakaleaf Pro 会长期维护吗?
Q07:Ayakaleaf Pro 是否合规?
Q07:Ayakaleaf Pro 是否合规?
Q08:为什么项目名为 Ayakaleaf Pro?
Q08:为什么项目名为 Ayakaleaf Pro?
Q09:Ayakaleaf Pro 与新近出现的 AI 构建的 LaTeX 编辑器有何不同?
Q09:Ayakaleaf Pro 与新近出现的 AI 构建的 LaTeX 编辑器有何不同?
Q10:GitHub 仓库 ayaka-notes/overleaf-pro 怎么了?
Q10:GitHub 仓库 ayaka-notes/overleaf-pro 怎么了?
ayaka-notes/overleaf-pro 链接和 Git 远程地址重定向到新名称。Docker 镜像保留原名 ghcr.io/ayaka-notes/overleaf-pro,因此你无需修改 config/overleaf.rc 或 config/version。功能
Q01:Ayakaleaf Pro 提供哪些功能?我可以申请新功能吗?
Q01:Ayakaleaf Pro 提供哪些功能?我可以申请新功能吗?
Q02:我开发了一些功能。我可以提交 PR 吗?它一定会被接受吗?
Q02:我开发了一些功能。我可以提交 PR 吗?它一定会被接受吗?
Q03:如何配置某项特定功能?
Q03:如何配置某项特定功能?
Q04:Python Runner 可以使用哪些 Python 库?
Q04:Python Runner 可以使用哪些 Python 库?
pip 安装的软件包及其他软件包均不可用。服务器上无需进行任何配置。Q05:拼写检查可以检查日语或中文吗?
Q05:拼写检查可以检查日语或中文吗?
Q06:我可以添加插件吗?
Q06:我可以添加插件吗?
services/web/modules 下的模块,它们被构建进 Docker 镜像,并通过本文档中的设置启用。如需添加你自己的功能,请在源代码中添加一个模块并构建你自己的镜像。部署
Q01:Ayakaleaf Pro 是否支持在 k8s 中进行分布式部署?
Q01:Ayakaleaf Pro 是否支持在 k8s 中进行分布式部署?
Q02:在为数千名用户提供服务时,如何确保可用性?
Q02:在为数千名用户提供服务时,如何确保可用性?
Q03:你们可以帮我部署或迁移吗?
Q03:你们可以帮我部署或迁移吗?
Q04:可以将 Ayakaleaf Pro 部署在 URL 子路径下吗,例如 https://example.com/overleaf?
Q04:可以将 Ayakaleaf Pro 部署在 URL 子路径下吗,例如 https://example.com/overleaf?
https://overleaf.example.com。Q05:可以在 Windows 或 macOS 上运行 Ayakaleaf Pro,或者不使用 Toolkit 运行吗?
Q05:可以在 Windows 或 macOS 上运行 Ayakaleaf Pro,或者不使用 Toolkit 运行吗?
docker-compose.yml。要查看 Toolkit 所使用的 Compose 配置,请在 Toolkit 目录中运行 bin/docker-compose config。Q06:如何卸载 Ayakaleaf Pro?
Q06:如何卸载 Ayakaleaf Pro?
- 使用
bin/docker-compose down停止并删除容器。 - 删除数据。默认情况下,数据位于 Toolkit 的
data/目录中。如果你在config/overleaf.rc中修改了OVERLEAF_DATA_PATH、MONGO_DATA_PATH、REDIS_DATA_PATH或GIT_BRIDGE_DATA_PATH,也请删除这些目录。此操作无法撤销,因此如果你可能还需要这些数据,请先进行备份。 - 删除 Toolkit 目录。
- 删除 Docker 镜像(可以使用
docker images列出):ghcr.io/ayaka-notes/overleaf-pro、git-bridge 镜像、mongo、redis以及 TeX Live 镜像。
Q07:如何停止、启动或重启 Ayakaleaf Pro?
Q07:如何停止、启动或重启 Ayakaleaf Pro?
bin/stop停止所有容器,bin/start重新启动它们。容器会被保留,因此用户会保持登录状态。bin/up -d创建容器并在后台启动。修改config/variables.env、config/overleaf.rc或config/version后请运行它:它会重新创建配置已更改的容器,更改只有在此之后才会生效。bin/stop和bin/start不会应用这些更改。bin/docker-compose restart sharelatex只重启 Overleaf 容器,不会应用配置更改。
bin/up 重新创建容器时用户都会被退出登录,请设置 OVERLEAF_SESSION_SECRET,参见环境变量中的问答。Q08:OAuth 回调 URL 应该填写在哪里?
Q08:OAuth 回调 URL 应该填写在哪里?
config/variables.env 中都没有回调设置:Ayakaleaf Pro 会根据 OVERLEAF_SITE_URL 构建每个回调 URL 并将其发送给服务提供方,如果它与为该应用注册的 URL 不一致,服务提供方会拒绝请求。因此,你只需在服务提供方处注册该 URL,并将 OVERLEAF_SITE_URL 设置为用户打开的地址。OVERLEAF_SITE_URL(例如改为新域名),也请在每个服务提供方处更新该 URL,否则关联将会失败。Q09:数据存储在哪里?我需要多少磁盘空间?
Q09:数据存储在哪里?我需要多少磁盘空间?
data/ 目录中:data/overleaf(项目文件、历史记录和编译输出)、data/mongo 和 data/redis。对于用户少于 1000 人的实例,我们推荐使用本地磁盘并定期进行备份。Ayakaleaf Pro 镜像约占用 5 GB。简介中所述的 40 GB 最低要求是针对沙盒编译的,其每个 texlive-full 镜像约占用 28 GB。如果不使用沙盒编译,编译会在 sharelatex 容器内运行,使用 TeX Live basic scheme 加上 latexmk、texcount、synctex、etoolbox 和 xetex,因此许多项目会因缺少宏包而编译失败。之后 data/ 目录会随着你的项目及其历史记录而增长;可使用 du -sh data/* 查看其大小。Q10:可以让 Ayakaleaf 在 Windows 上 24 小时持续运行吗?
Q10:可以让 Ayakaleaf 在 Windows 上 24 小时持续运行吗?
restart: always 策略,并在接通交流电源时禁用自动睡眠和休眠。屏幕可以关闭;笔记本合盖行为是另一项单独的设置。在 bin/up -d 之后关闭 Ubuntu 终端不会停止以分离模式运行的容器。退出 Docker Desktop、暂停其引擎或运行 wsl --shutdown 都会中断服务。Docker Desktop 的 Resource Saver 与 Windows 睡眠不同:它仅在没有容器运行时生效,因此正在运行的 Ayakaleaf 栈不会仅仅因为无人编辑而被视为空闲。Windows 重启后,登录时启动的设置仍需要有人登录。相关检查和恢复步骤请参阅保持实例可用。当可用性不能依赖于交互式桌面登录时,我们仍然推荐使用 Linux。Q11:Docker Desktop 提示虚拟化已禁用。我需要 Hyper-V 吗?
Q11:Docker Desktop 提示虚拟化已禁用。我需要 Hyper-V 吗?
wsl --list --verbose。0x80370102 等错误可能意味着虚拟化、该 Windows 功能或启动虚拟机监控程序已被禁用。请参阅 Windows 安装故障排除步骤,其中附有 Microsoft 和 Docker 的修复链接。启用所需功能后请重启 Windows;重新安装 Ayakaleaf 无法修复无法启动的 Docker 引擎。LaTeX
Q01:用户的 LaTeX 项目编译是否相互隔离?是否启用了 Shell Escape?
Q01:用户的 LaTeX 项目编译是否相互隔离?是否启用了 Shell Escape?
Q02:沙盒编译镜像可靠吗?编译会失败吗?
Q02:沙盒编译镜像可靠吗?编译会失败吗?
Q03:我的项目无法编译。你们可以帮我排查问题吗?
Q03:我的项目无法编译。你们可以帮我排查问题吗?

