appstore/apps/mixspace

MixSpace

产品介绍

MixSpace 是开源自部署的个人博客后端系统，当前 latest 和 13 版本均基于 PostgreSQL 和 Redis 运行。

主要功能

• 提供个人博客、内容管理和 API 服务。
• latest 和 13 版本使用 PostgreSQL 和 Redis，主服务启动时会自动执行数据库迁移。
• 两个版本使用不同镜像标签，但当前运行时依赖保持一致。

访问说明

安装完成后，通过应用表单中的 HTTP 端口访问 MixSpace API；首次部署请按上游文档配置前端和允许访问域名。

Introduction

MixSpace is an open-source self-hosted backend for personal blogs. The current latest and 13 versions run with PostgreSQL and Redis.

Features

• Provides personal blog, content management, and API services.
• The latest and 13 versions use PostgreSQL and Redis; the main service runs database migrations automatically during startup.
• Both versions use different image tags, but their current runtime dependencies are aligned.

应用简介

开源自部署个人前后端分离博客系统。

英文说明：Open source self-deployed personal front-end and back-end separation blogging system.

部署说明

• 本应用使用 Docker Compose 在 1Panel 中部署。
• 应用分类：网站。
• 支持架构：amd64。
• 可选版本：latest；固定版本以应用商店当前版本目录和安装表单为准。
• 安装后按应用表单中的端口访问 MixSpace API 或对应服务。

端口

变量	说明	默认值	必填
PANEL_APP_PORT_HTTP	端口	40203	是

数据持久化

• ${DATA_PATH}/mx-space:/root/.mx-space
• ${DATA_PATH}/postgres:/var/lib/postgresql/data
• ${DATA_PATH}/redis:/data

升级或迁移前，请在 1Panel 中备份上述数据目录。

升级说明

• 升级脚本会为旧 .env 补充缺失的 DATA_PATH、PG_PASSWORD、JWT_SECRET、SUBNET_PREFIX，并创建 PostgreSQL/Redis 持久化目录。
• 升级脚本会把自动生成的 PG_PASSWORD、JWT_SECRET 缓存在 ${DATA_PATH}/.mixspace_pg_password、${DATA_PATH}/.mixspace_jwt_secret，避免后续升级重复生成导致旧数据不可用。
• 旧版 MongoDB 数据目录 ${DATA_PATH}/db 会被保留，但不会自动迁移到 PostgreSQL。
• 从旧 MongoDB 拓扑升级前，请先完整备份应用目录，并按 MixSpace 上游文档评估数据迁移方案。

配置项

变量	说明	默认值	必填
DATA_PATH	数据根目录	./data	是
ALLOWED_ORIGINS	被允许的域名 (多个使用英文逗号分割)	-	是
JWT_SECRET	JWT 密钥 (16 到 32 位字符)	安装时自动生成	是
PG_PASSWORD	PostgreSQL 密码	安装时自动生成	是
ENCRYPT_KEY	加密密钥 (非特殊需求不建议填写,终端执行 "openssl rand -hex 32" 获取)	-	否
ENCRYPT_ENABLE	是否开启加密 (true或false,开启则需要填写加密密钥)	false	是
TIME_ZONE	时区	Asia/Shanghai	是
SUBNET_PREFIX	新 docker 网络子网前缀	10.250.0	是

使用说明

• 安装完成后，在 1Panel 应用页面查看运行状态、端口和日志。
• 首次安装时请填写 ALLOWED_ORIGINS、数据库参数和持久化目录；如需公网访问，请按上游说明单独部署前端并指向当前 API。
• 如果修改了 DATA_PATH、数据库目录或上传目录，请在升级前确认这些路径已完成备份。
• 如需对外开放访问，请同步检查防火墙、安全组和反向代理配置。

参考资料

• 官网: https://mx-space.js.org
• 文档: https://mx-space.js.org/docs
• 源码: https://github.com/mx-space/core