Tabby的Web前端与Gateway网关部署
内容提要
本文介绍了搭建tabby-web和tabby-gateway的详细配置步骤，包括使用docker和域名证书，修改SSL设置、端口映射、域名和密钥等。作者提供了解决方案来解决可能遇到的问题，并鼓励读者提问和提供帮助。
延伸解读
SSL 配置的两种路径
文章明确区分了开启与取消 SSL 两种部署方式。开启 SSL 时，网关需挂载证书目录，并将签名和私钥命名为 gateway.pem 和 gateway.key，同时网关端口映射为 443。取消 SSL 时，需修改网关启动命令、删除证书卷挂载，并将端口映射改为 9000。读者应根据自身环境选择对应配置，避免混用导致网关反复重启。
前端黑屏的成因与修复
部署 tabby-web 后可能出现黑屏，原因是前端依赖目录结构异常：版本目录下存在 tmpxxxx 子目录，而前端实际请求的文件位于该子目录内。文章给出的修复步骤是先将 tmpxxxx 下的文件移动到版本目录，再下载对应版本的源码包解压到 tmpxxxx 目录，最后重启容器。这一操作能解决文件路径不匹配导致的加载失败。
网关协议与连接要点
网关使用 WebSocket 协议，而非 HTTP。若配置了证书，前端填写网关地址时应使用 wss://网关域名:网关端口，而不是 http 反向代理。网关密钥通过环境变量 TABBY_AUTH_TOKEN 设置，相当于自定义密码。网关持续重启通常意味着证书目录挂载有误，需检查路径和文件命名是否正确。
版本选择与登录配置
文章建议使用 1.0.187-nightly.1 版本，并指出最新版 1.0.197-nightly.1 容易出现问题。安装依赖需在容器内执行 /manage.sh add_version 命令。前端访问后可通过 GitHub 登录，需提前创建 OAuth 应用并填写 SOCIAL_AUTH_GITHUB_KEY 和 SECRET，回调地址为前端域名。登录后可在设置中获取 token，用于客户端同步配置。
Q&A
如何搭建tabby-web和tabby-gateway？
搭建tabby-web和tabby-gateway需要使用docker和域名证书，并修改SSL设置、端口映射、域名和密钥等配置。
在搭建过程中需要注意哪些SSL设置？
需要根据是否开启SSL来填写网关证书目录、前端容器挂载目录、映射端口和网关密钥等信息。
如何解决前端黑屏问题？
前端黑屏问题可以通过将/tmpxxxx目录下的文件移动到1.0.187-nightly.1目录下并重启容器来解决。
tabby-gateway使用什么协议？
tabby-gateway使用ws协议，而web使用http协议。
如何使用Github登录配置tabby-web？
访问前端后，可以使用Github登录，登录后在设置中生成token进行配置。
docker-compose.yml文件中需要配置哪些内容？
docker-compose.yml文件中需要配置服务名称、镜像、端口映射、环境变量等信息。
