1Panel 面板部署

本文档提供使用 1Panel 面板部署 ThinkMaaS 的图文教程。

前置要求

步骤一：安装 1Panel 面板

步骤二：安装 ThinkMaaS

搜索应用

配置参数

• 名称：要创建的 ThinkMaaS 应用的名称
• 版本：选择 ThinkMaaS 的版本
• 端口：ThinkMaaS 应用的服务端口
• 时区：输入服务器所在时区（默认 Asia/Shanghai）
• 高级设置：务必勾选端口外部访问

确认安装

步骤三：配置环境变量（重要）

安装完成后，建议配置以下关键环境变量：

必要环境变量

配置方法

1. 在 1Panel 应用列表中，点击 ThinkMaaS 应用的 参数 按钮
2. 在环境变量区域添加： - SESSION_SECRET=your_random_secret_key - CRYPTO_SECRET=your_crypto_secret_key（可选）
3. 点击 确认 保存配置
4. 重启应用使配置生效

生成随机密钥

# 生成 SESSION_SECRET
openssl rand -hex 16

# 或使用 Linux 命令
head -c 16 /dev/urandom | xxd -p

步骤四：访问 ThinkMaaS

首次访问将自动引导到初始化页面，按照页面指引设置管理员账号与密码。

常见问题

无法访问应用界面

1. 检查应用状态是否为"已启动"
2. 确认端口是否正确映射并开放
3. 检查服务器防火墙和云服务器安全组

登录后提示会话失效

确保设置了 SESSION_SECRET 环境变量，且值不为空。

如何更新版本

1. 登录 1Panel 面板，进入 应用商店 → 可升级页面
2. 找到 ThinkMaaS 应用，点击 升级 按钮
3. 选择目标版本，点击 确认

数据如何持久化

1Panel 应用默认会将数据存储在 Docker 卷中。如需自定义存储位置：

1. 在应用参数设置中，配置目录映射
2. 确保 /data 目录映射到持久化存储

相关链接

• 环境变量配置
• Docker Compose 部署
• 常见问题
• GitHub 仓库