Gotab 新标签页私有化部署文档

1. 镜像概述与主要用途

Gotab 新标签页是 funtabs 新标签页的重构版本，前端基于 Vite 构建，后端采用 Golang 开发（单二进制文件部署），旨在为用户提供个性化浏览器新标签页、起始页及个人主页解决方案。该项目支持高度自定义配置，数据存储与同步，并提供丰富的功能组件，满足个人工作台的多样化需求。

2. 核心功能与特性

2.1 核心优势

• 免费开源、界面简洁、功能齐全且高度可配置
• 前后端分离架构，后端单文件部署，轻量化高效
• 支持私有化部署，数据自主可控

2.2 详细功能

• 精美小组件：多样化组件设计，支持自由选择与布局
• 聚合搜索：集成多搜索引擎，支持一键切换及群搜模式（同时打开多个搜索结果）
• 浏览器书签管理：支持本地书签批量导入与统一管理
• 灵活排序方式：常规排序、交换位置排序、自由拖拽（支持步长设置与网格调整）
• 自定义卡片布局：支持内网链接、多样式卡片（纯图/文本/横纵向）、字幕滚动名称、分类切换动画
• 双壁纸模式：静态/动态/纯色/渐变壁纸，标准/简约模式切换，支持双壁纸动态切换
• 简约模式：点击时间切换极简界面，支持文本自定义
• 数据同步与备份：时光机功能、多设备同步、本地备份，数据安全不丢失
• 资源库：内置全球优质网站图标库，支持用户提交分享
• 迁移与备份：支持数据导入导出、浏览器书签导入、通用格式导出
• 流畅用户体验：快速响应速度与丝滑动画效果

3. 使用场景与适用范围

适用场景

• 个人用户：打造个性化浏览器起始页，整合常用网站与工具
• 开发者：私有化部署内部导航页，管理内网服务与资源
• 团队/工作室：共享自定义导航页，统一资源访问入口

环境要求

• 服务器：支持 Docker 或直接运行二进制文件的环境
• 数据库：MySQL 8.0+（用于存储用户数据及网站信息）

4. 部署指南

4.1 Docker 部署（推荐）

4.1.1 基础部署命令

bash
docker run -d \
  --name gotab-server \
  -p 8080:8080 \
  -e SERVER_PORT=8080 \
  -v $(pwd)/uploads:/app/uploads \
  -v $(pwd)/sourceStore:/app/sourceStore \
  --mount type=bind,source=$(pwd)/config.toml,target=/app/config.toml \
  --restart always \
  doxwant/gotab:latest

4.1.2 目录映射说明

为确保数据持久化，需映射以下路径：

4.2 其他部署方式

4.2.1 手动部署

1. 准备文件：将 gotab-server 二进制文件与 /web 目录前端文件上传至服务器同一目录
2. 赋予权限：

   bash
   chmod 0755 gotab-server
   

3. 启动服务：

   bash
   # 默认端口启动
   ./gotab-server
   # 自定义端口启动
   ./gotab-server -port=8081
   

4.2.2 1panel 部署

1. 将 gotab-server 与 /web 目录文件上传至服务器，确保 gotab-server 权限为 0755
2. 进入 1panel 控制台，创建 Go 运行环境：
   • 自定义名称
   • 运行目录：项目文件所在文件夹
   • 启动命令：./gotab-server
3. 访问 IP:端口，首次打开将跳转至 /install 引导页面完成配置

4.2.3 宝塔面板部署

1. 上传项目文件至服务器，设置 gotab-server 执行权限
2. 通过宝塔面板创建网站，配置运行目录与启动命令（参考 1panel 步骤）
3. 启动服务并访问验证

5. 配置说明

5.1 环境变量

5.2 配置文件（config.toml）

该文件为程序核心配置，需通过 --mount 绑定映射，包含以下关键配置项：

• MySQL 数据库连接信息（地址、端口、用户名、密码、数据库名）
• 邮件服务器设置（用于用户注册、密码找回等）
• 网站标题、LOGO、默认主题等全局设置

5.3 数据库准备

• 需提前创建 MySQL 数据库（版本 8.0+）
• 数据库信息需在 config.toml 中配置，用于存储用户数据及网站信息

6. 注意事项

6.1 管理后台访问

• 路径：登录后访问 /console，或通过「管理员 - 我的 - 管理端」进入
• 默认管理员账号：admin，密码：***（首次登录建议修改）

6.2 缓存控制

• 以下文件/路径存在缓存机制，配置变更后需清理服务缓存：
  • /web/siteConfig.js（功能开关配置）
  • HTML 文件、/background.js
  • /api/* 路径接口响应

6.3 数据存储机制

• 未登录用户：数据仅存储在本地浏览器缓存
• 登录用户：数据存储于 MySQL 数据库，支持多设备同步
• 默认主页数据：由管理员在个人中心或管理后台配置，支持策略调整

7. 用户支持与资源

7.1 ***资源

• 项目地址：[***]
• 官网：[***]
• 在线预览：[***]admin，密码：***）

7.2 用户帮助

• QQ 交流群：727809499（反馈问题及获取实时支持）