nxprivatecloud/nx-cloud-file-server

镜像概述

nxcloud-file-server是NxCloud企业版本地部署架构的核心组件之一，专门为企业级NxCloud安装环境提供文件存储与服务支持。作为NxCloud本地部署方案的关键基础设施，该组件负责文件的持久化存储、访问控制及高效传输，确保企业用户在使用NxCloud服务时的文件操作需求得到稳定支持。更多信息可参考官方文档：[***]

核心功能与特性

• 文件存储管理：提供安全可靠的文件存储服务，支持多种文件类型的持久化存储与管理。
• 访问权限集成：与NxCloud权限系统深度集成，基于用户角色和权限策略控制文件访问范围，保障数据安全。
• 组件协同能力：无缝对接NxCloud其他企业级组件（如核心服务、认证服务等），确保整体系统功能完整性。
• 数据持久化支持：通过卷挂载机制实现文件数据持久化，避免容器重启或升级导致的数据丢失。
• 企业级兼容性：适配企业级IT环境需求，支持自定义存储路径、端口映射及网络配置。

使用场景与适用范围

• 企业本地部署NxCloud：作为企业内部部署NxCloud企业版时的必备文件服务组件，支撑文档管理、资源存储等核心业务场景。
• 本地化数据管控需求：满足对文件数据存储位置有严格本地化要求的企业（如***、政务、大型制造业等）。
• 高可控性IT架构：适用于需要自主管理基础设施、定制化配置文件服务参数的企业IT环境。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动文件服务器容器，需指定持久化存储路径及NxCloud核心服务地址：

bash
docker run -d \
  --name nxcloud-file-server \
  --restart unless-stopped \
  -p 8080:8080 \  # 文件服务端口映射（容器内默认8080）
  -v /local/path/to/storage:/data \  # 本地目录挂载（持久化文件存储）
  -e NX_CLOUD_HOST=nxcloud-core:9000 \  # NxCloud核心服务地址及端口
  -e STORAGE_PATH=/data \  # 容器内文件存储路径（需与卷挂载路径对应）
  -e LOG_LEVEL=info \  # 日志级别（可选：debug/info/warn/error）
  nxcloud/file-server:latest

环境变量配置

Docker Compose集成示例

在NxCloud本地部署架构中，可通过Docker Compose与其他组件协同部署，示例配置如下：

yaml
version: '3.8'
services:
  nxcloud-file-server:
    image: nxcloud/file-server:latest
    container_name: nxcloud-file-server
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - /local/nxcloud/storage:/data  # 本地持久化存储目录
    environment:
      - NX_CLOUD_HOST=nxcloud-core:9000  # 需与NxCloud核心服务容器名/IP对应
      - STORAGE_PATH=/data
      - LOG_LEVEL=info
    networks:
      - nxcloud-network  # 加入NxCloud组件共享网络

networks:
  nxcloud-network:
    external: true  # 假设已存在NxCloud组件共享网络

数据持久化说明

为避免容器重启或升级导致文件数据丢失，必须通过-v参数挂载本地目录至容器内STORAGE_PATH（默认/data）。建议选择高性能存储介质（如SSD）以提升文件读写效率。

依赖与集成要求

• 需与NxCloud企业版核心服务（nxcloud-core）部署在同一网络环境，确保NX_CLOUD_HOST参数可正确访问核心服务。
• 容器需具备网络访问权限，允许与NxCloud其他组件（如认证服务、数据库等）通信。
• 宿主机需预留足够存储空间，建议根据企业文件存储需求规划存储容量。