onlyoffice/appserver

ONLYOFFICE AppServer Docker镜像文档

镜像概述

ONLYOFFICE AppServer Docker镜像用于部署AppServer微服务，提供文档协作相关功能。该镜像支持两种部署模式：与Community Server集成运行，或作为独立服务运行。部署过程涉及微服务构建、环境变量配置及容器编排，适用于企业级文档协作平台的搭建。

核心功能与特性

• 微服务构建：通过docker-compose构建AppServer相关微服务组件
• JWT验证配置：支持通过环境变量配置JSON Web Token验证参数，确保服务安全
• 灵活部署模式：支持与Community Server集成部署或独立部署两种模式
• 数据卷管理：通过配置文件灵活管理数据卷挂载，适应不同部署需求

使用场景

• 企业内部文档协作平台搭建
• 需要与ONLYOFFICE Community Server集成的办公系统
• 独立部署的文档处理服务

使用方法

环境准备

1. 下载AppServer代码库：

   bash
   git clone https://github.com/ONLYOFFICE/AppServer.git
   

2. 进入Docker部署目录：

   bash
   cd ./AppServer/build/install/docker/
   

构建镜像

构建AppServer Docker微服务：

bash
docker-compose -f build.yml build

配置环境变量

编辑.env文件，检查并配置以下JWT验证相关参数：

• DOCUMENT_SERVER_JWT_SECRET：JWT密钥，用于服务间身份验证
• APP_CORE_MACHINEKEY：应用核心机器密钥
• DOCUMENT_SERVER_JWT_HEADER：JWT请求头名称

运行服务

1. 与Community Server集成运行

• 编辑appserver.yml配置文件：

  • 注释掉app_data:/app/onlyoffice/data
  • 取消注释/app/onlyoffice/CommunityServer/data:/app/onlyoffice/data

• 启动服务：

  bash
  docker-compose -f appserver.yml up -d
  

2. 独立运行AppServer

• 编辑appserver.yml配置文件：

  • 取消注释app_data:/app/onlyoffice/data
  • 注释掉/app/onlyoffice/CommunityServer/data:/app/onlyoffice/data

• 启动数据库服务：

  bash
  docker-compose -f db.yml up -d
  

• 启动AppServer服务：

  bash
  docker-compose -f ds.yml -f appserver.yml up -d