Docker 部署 mTab 书签管理系统 📚

mtab 书签管理系统

📋 目录导航

🎯 项目简介

mTab 是一个开源的现代化书签管理系统，提供优雅的界面和强大的书签管理功能。通过 Docker 部署，您可以轻松搭建个人或团队的书签管理平台，实现跨设备同步和高效的书签组织。

🛠️ 核心特性

特性类别 功能描述 优势
🌐 现代化界面 简洁美观的用户界面设计 提供优雅的书签浏览体验
🔖 智能分类 支持标签、文件夹等多维度分类 灵活组织和管理书签
🔍 强大搜索 快速全文搜索书签内容 快速定位所需书签资源
📱 响应式设计 完美适配桌面和移动设备 跨设备一致的使用体验
👥 多用户支持 支持团队协作和权限管理 适合个人和团队使用
📂 导入导出 支持浏览器书签导入导出 方便数据迁移和备份
🐳 容器化部署 使用 Docker 简化安装和维护 快速部署和升级

🐳 一、Docker 部署 mTab

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
mkdir -p /mnt/mydisk/home/mtab && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  mysql8:
    image: mysql:8.0
    container_name: mtab_sql
    restart: always
    ports:
      - "9201:3306"
    volumes:
      - ./mysql:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: mtab_root_password
      MYSQL_DATABASE: mtab
      MYSQL_USER: mtab_user
      MYSQL_PASSWORD: mtab_password
      TZ: Asia/Shanghai
    networks:
      - mtab-network

  mtab-app:
    container_name: mtab
    image: itushan/mtab:latest
    restart: always
    ports:
      - "9200:80"
    volumes:
      - ./app:/app
      - ./uploads:/app/uploads
    environment:
      MYSQL_HOST: mtab_sql
      MYSQL_USER: mtab_user
      MYSQL_PORT: 3306
      MYSQL_PASSWORD: mtab_password
      MYSQL_DATABASE: mtab
      ADMIN_USER: admin
      ADMIN_PASSWORD: your_secure_password_here
    depends_on:
      - mysql8
    networks:
      - mtab-network

networks:
  mtab-network:
    driver: bridge
EOF

🔐 安全提示：部署后请立即修改默认密码，建议使用密码管理器生成强密码！

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用指南

1. 访问 Web 界面 💻

  • 本地访问: http://localhost:9200
  • IP访问: http://服务器IP:9200
  • 域名访问: 配置反向代理后可使用域名访问

2. 初始设置步骤 🎯

  1. 打开浏览器访问上述地址
  2. 使用默认管理员账号登录：
    • 用户名：admin
    • 密码：your_secure_password_here
  3. 立即修改默认密码
  4. 配置系统基本设置
  5. 导入浏览器书签或开始添加新书签

🌐 三、Nginx 反向代理配置

访问地址示例：https://bookmarks.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/mtab.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name bookmarks.example.com;

    # SSL 证书
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_ciphers ECDHE+AESGCM:ECDHE+CHACHA20:!aNULL:!MD5;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:9200;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 错误页
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 进入项目目录
cd /mnt/mydisk/home/mtab

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop mtab
docker start mtab  
docker restart mtab

# 删除容器
docker rm mtab
docker rm -f mtab

# 进入容器Shell
docker exec -it mtab sh
docker exec -it mtab bash

# 查看容器详情和资源使用
docker inspect mtab
docker stats mtab

# 容器日志管理
docker logs mtab
docker logs -f mtab
docker logs --tail 100 mtab
docker logs -t mtab

3. Docker 镜像管理 📀

1
2
3
4
5
docker images
docker rmi itushan/mtab:latest
docker rmi mysql:8.0
docker image prune -f
docker image prune -a -f

🌟 启航书签，效率无限

通过本文档，你已经成功使用 Docker 部署了 mTab 书签管理系统，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

📚 智能管理 优雅地组织和分类所有书签，打造个人知识管理体系
🌐 跨设备同步 随时随地访问你的书签收藏，实现多设备无缝衔接
🔍 高效检索 快速找到所需资源，提升工作和学习效率

书签之路，是一场与知识积累相伴的成长旅程。愿 mTab 成为你得力的知识管理助手，陪伴你在每一次信息收集和资源整理的重要时刻。

从现在开始，有序管理，高效访问——构建你个性化的知识宝库吧！🚀

📌 持续迭代：建议关注 mTab 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你使用愉快，效率倍增！🎉