WiseMapping Docker - 完整用户指南

![Docker 拉取量]([] ![Docker 星标数]([]

关于 WiseMapping

WiseMapping 是一款功能强大的基于 Web 的思维导图应用，可帮助用户通过直观的可视化图表组织想法、规划项目和呈现复杂信息。无论是头脑风暴、记笔记还是构建思维结构，WiseMapping 都提供了易于使用的界面，用于创建和分享思维导图。

核心功能

• 现代化 Web 界面：简洁、响应式设计，支持桌面、平板和移动设备
• 丰富的视觉元素：支持图标、颜色、字体和自定义样式，使思维导图更具视觉吸引力
• 实时协作：与团队成员共享思维导图并实时协作编辑
• 多平台访问：通过任何设备的 Web 浏览器访问您的思维导图
• 隐私与安全：自托管解决方案让您完全控制数据
• 导出选项：支持导出为多种格式（PDF、PNG、SVG 等）
• 搜索与导航：快速查找所有思维导图中的内容
• 富文本支持：为节点添加详细注释、链接和格式化文本
• 多语言支持：包括英语、西班牙语、法语、德语、意大利语、俄语和中文等多种语言

适用场景

• 商业规划：战略会议、项目路线图和组织架构图
• 教育领域：学***指南、课程规划和知识组织
• 个人使用：目标设定、***惯跟踪和个人项目管理
• 团队协作：会议记录、头脑风暴会议和工作流程文档
• 研究工作：信息收集、分析和知识图谱构建

试用 WiseMapping

• 在线演示：[***]
• 网站：[]
• 文档：[***]

---

Docker 部署

WiseMapping 现已提供完整的全栈 Docker 镜像，单个容器中包含后端 API 和前端 UI。这种自包含解决方案使部署简单且安全，让您完全控制思维导图数据和基础设施。

快速开始

1. 拉取最新镜像

bash
docker pull wisemapping/wisemapping:latest

2. 使用持久化数据运行（推荐）

bash
# 创建配置文件
cat > app.yml <<EOF
spring:
  datasource:
    url: jdbc:hsqldb:file:/var/lib/wisemapping/db/wisemapping;sql.names=false;sql.regular_names=false;shutdown=true
    driver-class-name: org.hsqldb.jdbc.JDBCDriver
    username: sa
    password: ''
  jpa:
    hibernate:
      ddl-auto: update
EOF

# 使用持久化 HSQLDB 运行
docker run -d --name wisemapping -p 80:80 \
  -v wisemapping-db:/var/lib/wisemapping \
  -v $(pwd)/app.yml:/app/config/app.yml:ro \
  wisemapping/wisemapping:latest

3. 访问应用

• 前端：http://localhost
• API：http://localhost/api
• 健康检查：http://localhost/health

默认情况下，系统会创建用户：***，密码：test，可用于登录。

数据库配置

HSQLDB（默认 - 内存模式）

bash
# 快速测试（容器停止后数据将丢失）
docker run -d --name wisemapping -p 80:80 wisemapping/wisemapping:latest

HSQLDB（持久化文件模式）

yaml
# app.yml
spring:
  datasource:
    url: jdbc:hsqldb:file:/var/lib/wisemapping/db/wisemapping;sql.names=false;sql.regular_names=false;shutdown=true
    driver-class-name: org.hsqldb.jdbc.JDBCDriver
    username: sa
    password: ''
  jpa:
    hibernate:
      ddl-auto: update

挂载目录：容器内 /var/lib/wisemapping/db/
Docker 卷：wisemapping-db

PostgreSQL

yaml
# app.yml
spring:
  datasource:
    url: jdbc:postgresql://postgres:5432/wisemapping
    username: wisemapping
    password: your_password
    driver-class-name: org.postgresql.Driver
  jpa:
    hibernate:
      ddl-auto: validate
    properties:
      hibernate:
        dialect: org.hibernate.dialect.PostgreSQLDialect
  sql:
    init:
      platform: postgresql

MySQL/MariaDB

yaml
# app.yml
spring:
  datasource:
    url: jdbc:mysql://mysql:3306/wisemapping?useUnicode=true&characterEncoding=utf8
    username: wisemapping
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: validate
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQLDialect
  sql:
    init:
      platform: mysql

完整示例

示例 1：HSQLDB 与 Docker 卷

bash
# 创建配置
cat > app.yml <<EOF
spring:
  datasource:
    url: jdbc:hsqldb:file:/var/lib/wisemapping/db/wisemapping;sql.names=false;sql.regular_names=false;shutdown=true
    driver-class-name: org.hsqldb.jdbc.JDBCDriver
    username: sa
    password: ''
  jpa:
    hibernate:
      ddl-auto: update
EOF

# 使用持久化存储运行
docker run -d \
  --name wisemapping \
  -p 80:80 \
  -v wisemapping-db:/var/lib/wisemapping \
  -v $(pwd)/app.yml:/app/config/app.yml:ro \
  wisemapping/wisemapping:latest

示例 2：HSQLDB 与主机目录

bash
# 创建主机目录
mkdir -p /path/to/wisemapping-data

# 创建指向挂载路径的配置
cat > app.yml <<EOF
spring:
  datasource:
    url: jdbc:hsqldb:file:/var/lib/wisemapping/db/wisemapping;sql.names=false;sql.regular_names=false;shutdown=true
    driver-class-name: org.hsqldb.jdbc.JDBCDriver
    username: sa
    password: ''
  jpa:
    hibernate:
      ddl-auto: update
EOF

# 使用主机挂载运行
docker run -d \
  --name wisemapping \
  -p 80:80 \
  -v /path/to/wisemapping-data:/var/lib/wisemapping \
  -v $(pwd)/app.yml:/app/config/app.yml:ro \
  wisemapping/wisemapping:latest

示例 3：PostgreSQL 与 Docker Compose

yaml
# docker-compose.yml
version: '3.8'
services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: wisemapping
      POSTGRES_USER: wisemapping
      POSTGRES_PASSWORD: password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  wisemapping:
    image: wisemapping/wisemapping:latest
    ports:
      - "80:80"
    volumes:
      - ./app.yml:/app/config/app.yml:ro
    depends_on:
      - postgres

volumes:
  postgres_data:

yaml
# app.yml
spring:
  datasource:
    url: jdbc:postgresql://postgres:5432/wisemapping
    username: wisemapping
    password: password
    driver-class-name: org.postgresql.Driver
  jpa:
    hibernate:
      ddl-auto: validate
    properties:
      hibernate:
        dialect: org.hibernate.dialect.PostgreSQLDialect
  sql:
    init:
      platform: postgresql

重要路径与端口

容器路径

• 配置：/app/config/app.yml（在此处挂载您的配置）
• HSQLDB 数据库：/var/lib/wisemapping/db/（用于持久化存储）
• 应用用户：wisemapping（UID 1001）
• 日志：通过 docker logs wisemapping 查看

端口

• 80 端口：所有流量（Nginx 路由到前端或后端）
  • 前端：http://localhost
  • API：http://localhost/api
  • 健康检查：http://localhost/health

环境变量

Java 内存配置

bash
docker run -d \
  --name wisemapping \
  -p 80:80 \
  -e JAVA_OPTS="-Xmx2048m -Xms1024m" \
  wisemapping/wisemapping:latest

数据管理

备份 HSQLDB 数据

bash
# 停止容器
docker stop wisemapping

# 备份数据
docker run --rm \
  -v wisemapping-db:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/wisemapping-backup-$(date +%Y%m%d).tar.gz -C /data .

# 重启容器
docker start wisemapping

恢复 HSQLDB 数据

bash
# 停止并删除容器
docker stop wisemapping && docker rm wisemapping

# 恢复数据
docker run --rm \
  -v wisemapping-db:/data \
  -v $(pwd):/backup \
  alpine sh -c "cd /data && tar xzf /backup/wisemapping-backup-YYYYMMDD.tar.gz"

# 再次启动容器
docker run -d \
  --name wisemapping \
  -p 80:80 \
  -v wisemapping-db:/var/lib/wisemapping \
  -v $(pwd)/app.yml:/app/config/app.yml:ro \
  wisemapping/wisemapping:latest

故障排除

查看日志

bash
# 所有日志
docker logs -f wisemapping

# 仅后端日志
docker exec wisemapping tail -f /var/log/supervisor/spring-boot-stdout---supervisor-*.log

# Nginx 日志
docker exec wisemapping tail -f /var/log/nginx/access.log

端口已被占用

bash
# 使用不同端口
docker run -d --name wisemapping -p 8080:80 wisemapping/wisemapping:latest

权限问题

bash
# 修复主机目录所有权
sudo chown -R 1001:1001 /path/to/wisemapping-data

数据库连接问题

• 确保外部数据库正在运行且可访问
• 检查 app.yml 配置中的凭据
• 验证容器之间的网络连接
• 对于 HSQLDB：确保卷已正确挂载且可写

生产环境建议

1. 使用外部数据库（推荐 PostgreSQL）
2. 设置定期备份
3. 配置资源限制
4. 使用 HTTPS 反向代理
5. 设置监控
6. 修改默认管理员凭据

架构

Docker 镜像采用单端口设计：

• Nginx（80 端口）处理所有请求
• 将 /api/* 路由到 Spring Boot 后端（内部 8080 端口）
• 为所有其他请求提供前端静态文件
• Supervisor 管理 Nginx 和 Spring Boot 进程

此设计消除了 CORS 问题，并通过仅需暴露一个端口简化了部署。

高级配置

自定义应用属性

yaml
# app.yml
app:
  admin:
    user: ***
  mail:
    sender-*** ***
    enabled: true
    host: smtp.example.com
    port: 587
    username: ***
    password: your_password
  security:
    oauth2:
      google:
        enabled: true
        clientId: YOUR_CLIENT_ID
        clientSecret: YOUR_CLIENT_SECRET
  site:
    ui-base-url: [***]
    api-base-url: [***]

使用反向代理配置 SSL/HTTPS

yaml
# 带 Traefik 的 docker-compose.yml
version: '3.8'
services:
  wisemapping:
    image: wisemapping/wisemapping:latest
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.wisemapping.rule=Host(`your-domain.com`)"
      - "traefik.http.routers.wisemapping.tls=true"
      - "traefik.http.routers.wisemapping.tls.certresolver=letsencrypt"
      - "traefik.http.services.wisemapping.load***.server.port=80"
    volumes:
      - ./app.yml:/app/config/app.yml:ro

从源码构建

如需从源码构建 Docker 镜像：

bash
# 克隆仓库
git clone [***]
cd wisemapping-open-source

# 使用默认前端分支（main）构建
docker build -f distribution/app/Dockerfile -t wisemapping:latest .

# 使用特定前端分支构建
docker build -f distribution/app/Dockerfile \
  --build-arg FRONTEND_BRANCH=develop \
  --build-arg CACHEBUST=$(date +%s) \
  -t wisemapping:develop .

支持

• GitHub 仓库：[***]
• 问题跟踪：[***]
• 文档：[***]

许可

Copyright [2007-2025] [wisemapping]

根据 WiseMapping 公共许可协议 1.0 版（"许可"）授权。 详见 [***]# WiseMapping Docker - 完整用户指南

![Docker 拉取量]([] ![Docker 星标数]([]

关于 WiseMapping

WiseMapping 是一款功能强大的基于 Web 的思维导图应用，可帮助用户组织想法、规划项目并通过直观的可视化图表呈现复杂信息。无论是头脑风暴、记笔记还是构建思维结构，WiseMapping 都提供易于使用的界面，用于创建和分享思维导图。

核心功能

• 现代化 Web 界面：简洁的响应式设计，支持桌面、平板和移动设备
• 丰富的视觉元素：支持图标、颜色、字体和自定义样式，使思维导图更具视觉吸引力
• 实时协作：与团队成员共享思维导图并实时协作编辑
• 多平台访问：通过任何设备的 Web 浏览器访问您的思维导图
• 隐私与安全：自托管解决方案让您完全控制数据
• 多种导出选项：支持导出为 PDF、PNG、SVG 等多种格式
• 搜索与导航：快速查找所有思维导图中的内容
• 富文本支持：为节点添加详细注释、链接和格式化文本
• 多语言支持：包括英语、西班牙语、法语、德语、意大利语、俄语和中文等

适用场景

• 商业规划：战略会议、项目路线图和组织架构图
• 教育领域：学***指南、课程规划和知识组织
• 个人使用：目标设定、***惯跟踪和个人项目管理
• 团队协作：会议记录、头脑风暴会议和工作流程文档
• 研究工作：信息收集、分析和知识图谱构建

试用 WiseMapping

• 在线演示：[***]
• 网站：[]
• 文档：[***]

---

Docker 部署

WiseMapping 提供完整的全栈 Docker 镜像，单个容器中包含后端 API 和前端 UI。这种自包含解决方案使部署简单且安全，让您完全控制思维导图数据和基础设施。

快速开始

1. 拉取最新镜像

bash
docker pull wisemapping/wisemapping:latest

2. 使用持久化数据运行（推荐）

bash
# 创建