如何搭建Tabby Web私有部署环境？Docker Compose实战教程

【免费下载链接】tabby-web Tabby Web - an SSH/Telnet/Serial client in your browser. 项目地址: https://gitcode.com/gh_mirrors/ta/tabby-web

Tabby Web是一款功能强大的浏览器端SSH/Telnet/Serial客户端，让你通过网页就能轻松管理远程服务器。本教程将带你使用Docker Compose快速搭建Tabby Web私有部署环境，无需复杂配置，小白也能轻松上手！

📋 准备工作：环境要求

在开始部署前，请确保你的服务器满足以下条件：

• Docker Engine (20.10+)
• Docker Compose (v2+)
• 至少1GB内存和10GB可用磁盘空间
• 开放9090端口（可自定义）

🔄 第一步：获取项目代码

首先克隆官方仓库到本地：

git clone https://gitcode.com/gh_mirrors/ta/tabby-web
cd tabby-web

⚙️ 第二步：配置Docker Compose文件

项目提供了预构建镜像的配置文件docker-compose.prebuilt.yml，无需手动编译即可快速部署。文件结构如下：

services:
  tabby:
    image: ghcr.io/eugeny/tabby-web:latest
    restart: always
    depends_on:
    - db
    ports:
    - 9090:80
    environment:
    - DATABASE_URL=mysql://root:123@db/tabby
    - PORT=80
    - DEBUG=False
  
  db:
    image: mariadb:10.7.1
    restart: always
    environment:
      MARIADB_DATABASE: tabby
      MARIADB_USER: user
      MARIADB_PASSWORD: 123
      MYSQL_ROOT_PASSWORD: 123
    volumes:
    - db-data:/var/lib/mysql

volumes:
  db-data:

🔒 安全提示：修改默认密码

默认配置中使用了简单密码，生产环境请务必修改以下参数：

• MARIADB_PASSWORD
• MYSQL_ROOT_PASSWORD
• DATABASE_URL中的密码部分

🚀 第三步：启动服务

使用以下命令启动Tabby Web服务：

docker-compose -f docker-compose.prebuilt.yml up -d

首次启动会自动拉取镜像并初始化数据库，可能需要3-5分钟。可以通过以下命令查看启动状态：

docker-compose -f docker-compose.prebuilt.yml logs -f

🌐 第四步：访问Tabby Web界面

服务启动后，在浏览器中访问 http://你的服务器IP:9090，即可看到Tabby Web的登录界面。

Tabby Web主界面支持多标签页管理多个远程连接

🔑 第五步：配置认证（必做）

默认配置未启用认证，生产环境必须配置至少一种OAuth认证方式。编辑docker-compose.prebuilt.yml，取消注释并配置以下任意一种 OAuth provider：

# GitHub OAuth
# - SOCIAL_AUTH_GITHUB_KEY=your_github_client_id
# - SOCIAL_AUTH_GITHUB_SECRET=your_github_client_secret

# Google OAuth
# - SOCIAL_AUTH_GOOGLE_OAUTH2_KEY=your_google_client_id
# - SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET=your_google_client_secret

修改后重启服务：

docker-compose -f docker-compose.prebuilt.yml down
docker-compose -f docker-compose.prebuilt.yml up -d

💻 使用示例：SSH连接远程服务器

成功登录后，你可以轻松创建SSH连接：

1. 点击界面左上角"+"按钮
2. 选择"SSH"连接类型
3. 输入服务器地址、端口和凭据
4. 点击"连接"按钮

Tabby Web的SSH连接界面支持密钥认证和端口转发

📚 官方文档与资源

• 部署文档：docs/DEPLOYMENT.md
• 前端源代码：frontend/src/
• 后端API代码：backend/tabby/app/api/

❓ 常见问题解决

1. 服务启动失败？ 检查9090端口是否被占用，或查看日志定位问题：

   docker-compose -f docker-compose.prebuilt.yml logs tabby
   

2. 忘记数据库密码？ 通过Docker直接连接数据库容器修改：

   docker exec -it tabby-web_db_1 mysql -u root -p
   

3. 如何更新版本？

   docker-compose -f docker-compose.prebuilt.yml pull
   docker-compose -f docker-compose.prebuilt.yml up -d
   

通过以上步骤，你已经成功搭建了自己的Tabby Web私有部署环境。现在可以在浏览器中安全便捷地管理所有远程服务器了！🎉

【免费下载链接】tabby-web Tabby Web - an SSH/Telnet/Serial client in your browser. 项目地址: https://gitcode.com/gh_mirrors/ta/tabby-web