visionect/visionect-server-v3

Visionect Server 3 (VSS) 容器化部署与许可政策文档

镜像概述和主要用途

Visionect Server 3 (VSS) 是一款容器优先的服务器软件，主要用于设备连接管理与配置。自2024年4月发布的7.7.0版本起，VSS实施硬许可执行政策，要求每个连接设备都需购买许可。该软件默认通过Docker容器运行，不再提供原生Ubuntu包，支持PostgreSQL数据库和Redis缓存，适用于本地部署和云环境。

核心功能和特性

许可政策核心变更（2024年4月起）

• 硬许可执行：从"软"执行转向"硬"执行模型，未授权实例将限制设备连接数为0
• 定期许可验证：VSS实例定期与许可服务器通信，验证许可允许的设备数量
• 许可分发模型：优化许可分发与管理流程，提升用户体验

分发流程

• 实例标识：每个VSS实例通过唯一ID识别，ID嵌入docker-compose.yaml文件，可从服务器下载（初期由支持团队提供链接）
• 试用许可：每个实例配备初始试用许可，与VSS ID绑定（初期由支持团队管理）
• 许可续费：试用期结束后，Chargebee将提示用户付费续期，未付费将导致设备连接限制

使用场景和适用范围

适用客户类型

• 本地部署客户：根据客户类别（含大型客户及状态未知客户）采用差异化过渡策略，确保平稳迁移至新模型
• 云客户：已在Chargebee拥有有效许可，无需立即操作，将通过分阶段部署更新至7.7.0版本

不适用场景

• 不支持7.7.0以下版本的长期使用，将逐步限制对旧版本的支持
• 免费层级用户将受到使用限制，需升级至付费许可

详细使用方法和配置说明

环境要求

• Docker引擎（支持大多数现代操作系统，Windows Server 2016及以上原生集成）
• PostgreSQL数据库（9.4及以上版本）
• Redis（用于缓存）

警告事项

• 升级至VSS 6.5.x版本可能导致数据库迁移时间延长（根据数据库大小，从几分钟到一小时不等），迁移期间服务器不可用
• 生产环境不推荐使用容器化数据库部署，可能影响性能和稳定性

快速启动

使用Docker命令部署

1. 创建PostgreSQL容器

sh
docker run -d --restart=always -e POSTGRES_PASSWORD=visionect -e POSTGRES_USER=visionect -e POSTGRES_DB=koala --name vserver_postgres postgres

2. 创建数据容器（用于持久化存储日志、固件包和配置文件）

sh
docker create --name vdata visionect/visionect-server-v3

3. 运行VSS容器

sh
docker run --privileged --cap-add=MKNOD --cap-add SYS_ADMIN -v /dev/shm:/dev/shm --device /dev/fuse -d --restart=always -p 8081:8081 -p 11112:11112 -p 11113:11113 --link vserver_postgres:db2_1 --volumes-from vdata --name vserver visionect/visionect-server-v3

使用Docker Compose部署

创建docker-compose.yml文件：

yaml
version: "3"
services:
  vserver3:
    container_name: vss
    image: visionect/visionect-server-v3
    privileged: true
    ulimits:
      core: 0
    depends_on:
      - redis
      - postgres_db
    cap_add:
      - MKNOD
      - SYS_ADMIN
    devices:
      - "/dev/fuse:/dev/fuse"
    restart: always
    links:
      - "postgres_db:postgres"
      - "redis:redis"
    ports:
      - 8081:8081
      - 11113:11113
    environment:
      - DB2_1_PORT_5432_TCP_ADDR=postgres
      - DB2_1_PORT_5432_TCP_USER=visionect
      - DB2_1_PORT_5432_TCP_PASS=visionect
      - DB2_1_PORT_5432_TCP_DB=koala
      - REDIS_ADDRESS=redis:6379
      - VISIONECT_SERVER_ADDRESS=localhost
    volumes:
      - /dev/shm:/dev/shm
  postgres_db:
    container_name: pdb
    image: postgres:latest
    restart: always
    ports: 
      - 5432:5432
    environment:
      - POSTGRES_USER=visionect
      - POSTGRES_DB=koala
      - POSTGRES_PASSWORD=visionect
      - PGPASSWORD=visionect
    volumes:
      - ./pgdata:/var/lib/postgresql/data
  redis:
    image: redis
    restart: always

启动服务：

sh
docker-compose up

高级安装指南

1. PostgreSQL安装

1.1 使用现有PostgreSQL

若已有9.4及以上版本PostgreSQL，只需为VSS创建新数据库即可。

1.2 容器化PostgreSQL（非生产推荐）

sh
docker run -d --restart=always -e POSTGRES_PASSWORD=visionect -e POSTGRES_USER=visionect -e POSTGRES_DB=koala --name vserver_postgres postgres

PostgreSQL容器升级

需手动迁移数据，建议参考：

• PostgreSQL迁移文档
• https://hub.docker.com/_/postgres/

1.3 直接在主机安装PostgreSQL（Ubuntu示例）

1. 安装PostgreSQL：

sh
apt-get install postgresql-server

2. 创建数据库和用户：

sh
sudo -u postgres psql postgres
postgres=# create user visionect;
postgres=# \password visionect
postgres=# create database koala with owner=visionect;
postgres=# \q

3. 配置网络访问：
   • 修改/etc/postgresql/[版本]/main/postgresql.conf：

     listen_addresses = '*'  # 生产环境建议限制为特定IP
     

   • 修改/etc/postgresql/[版本]/main/pg_hba.conf：

     host  koala  visionect  0.0.0.0/0  md5  # 生产环境建议限制来源IP
     

2. Visionect Server容器安装

1. 创建数据容器

sh
docker create --name vdata visionect/visionect-server-v3

2. 运行VSS容器

   • PostgreSQL在同一主机Docker中：

   sh
   docker run --privileged --cap-add=MKNOD --cap-add SYS_ADMIN --device /dev/fuse -v /dev/shm:/dev/shm -d --restart=always -p 8081:8081 -p 11112:11112 -p 11113:11113 --link vserver_postgres:db2_1 -e DB2_1_PORT_5432_TCP_USER='visionect' -e DB2_1_PORT_5432_TCP_PASS='visionect' -e DB2_1_PORT_5432_TCP_DB='koala' --volumes-from vdata --name vserver visionect/visionect-server-v3
   

   • 外部PostgreSQL：

   sh
   docker run --privileged --cap-add=MKNOD --cap-add SYS_ADMIN -v /dev/shm:/dev/shm --device /dev/fuse -d --restart=always -p 8081:8081 -p 11112:11112 -p 11113:11113 -e DB2_1_PORT_5432_TCP_ADDR='POSTGRES_IP' -e DB2_1_PORT_5432_TCP_USER='visionect' -e DB2_1_PORT_5432_TCP_PASS='visionect' -e DB2_1_PORT_5432_TCP_DB='koala' --volumes-from vdata --name vserver visionect/visionect-server-v3
   

从Visionect Server 2迁移

1. 升级并移除旧版本

sh
sudo apt-get update && apt-get install koala2
sudo apt-get remove koala2

2. 准备配置迁移

sh
VISIONECT_SERVER_CONFIG=`cat /opt/visionect/koala2/config.json`

3. 创建新容器

sh
docker create --name vdata visionect/visionect-server-v3
docker run --privileged --cap-add=MKNOD --cap-add SYS_ADMIN -v /dev/shm:/dev/shm --device /dev/fuse -d --restart=always -p 8081:8081 -p 11112:11112 -p 11113:11113 -e VISIONECT_SERVER_CONFIG="$VISIONECT_SERVER_CONFIG" -e DB2_1_PORT_5432_TCP_ADDR='POSTGRES_IP' -e DB2_1_PORT_5432_TCP_USER='visionect' -e DB2_1_PORT_5432_TCP_PASS='visionect' -e DB2_1_PORT_5432_TCP_DB='koala' --volumes-from vdata --name vserver visionect/visionect-server-v3

环境变量说明

数据库相关（必填，使用外部PostgreSQL时）

• DB2_1_PORT_5432_TCP_ADDR：PostgreSQL服务器地址
• DB2_1_PORT_5432_TCP_PORT：PostgreSQL端口
• DB2_1_PORT_5432_TCP_USER：数据库用户名（默认：visionect）
• DB2_1_PORT_5432_TCP_PASS：数据库密码（默认：visionect）
• DB2_1_PORT_5432_TCP_DB：数据库名（默认：koala）
• REDIS_PASSWORD：Redis密码（无密码时留空）

服务器配置（可选）

• VISIONECT_SERVER_CONFIG：JSON格式的服务器配置内容，首次运行时使用
• VISIONECT_SERVER_DEPLOYMENT_KEY：覆盖配置中的部署密钥，用于标识部署组件
• VISIONECT_SERVER_MASTER_HOST：主/从配置中的主服务器地址

立即行动项

用户需采取的措施

• 关注即将发布的通讯和邮件，了解许可政策变更详情
• 计划升级至VSS 7.7.0及以上版本，以确保持续获得支持
• 准备试用许可到期后的续费流程

支持限制

• 即日起限制对7.7.0以下版本的支持
• 支持团队将重点处理新版本使用问题及旧版本过渡咨询

特殊注意事项

• 数据迁移：升级过程中建议备份数据库，特别是从旧版本迁移时
• 安全实践：部署时请遵循系统安全最佳实践，限制网络访问范围
• 性能考虑：大型部署建议使用独立PostgreSQL服务器，而非容器化部署
• 生产环境：重要生产环境建议先在测试环境验证升级流程，再进行生产部署

我们理解变更可能带来挑战，支持团队将全程协助您完成过渡。如有任何问题或疑虑，请随时联系支持团队。