Valentina Server 是什么？

Valentina Server（有时简称为VServer）是一个完整的服务器平台，包含多个服务器并提供多种服务。

最初发布时，Valentina Server主要作为Paradigma Software的Valentina DB对象关系数据库的多用户环境。此后，Valentina Server已扩展到包含更多服务器和功能，例如：

• Valentina DB Server – 管理Valentina数据库文件，提供多用户数据访问。
• Valentina SQLite Server – 管理SQLite数据库文件，提供多用户数据访问。了解更多。
• Valentina DuckDB Server – 管理DuckDB数据库文件，提供多用户数据访问。
• Valentina Reports Server – 提供对Valentina报表引擎的多用户访问。报表可使用Valentina、SQLite、DuckDB、MySQL、PostgreSQL、ODBC和SQL Server数据库作为数据源，支持导出为多种格式（PDF、HTML、ODT、图像）或直接发送到打印机。
• Valentina Forms Server – 提供对存储在Valentina项目文件中的表单对象的多用户访问。

支持的架构

Docker镜像支持以下架构：

• 64位Linux
• 32位ARM Linux
• 64位ARM Linux

这些镜像合并为单个多架构镜像。Docker会自动选择正确的架构，除非用户明确指定。

您可以在macOS、Linux和Windows系统上使用此镜像。

其他资源

有关Valentina Server和Paradigma Software其他产品的更多信息及相关下载，请访问：
[***]

建议下载Valentina Studio，这是一款桌面应用，用于管理数据库、表、字段、存储过程，以及设计报表和表单。

!Valentina Server Logo

如何使用此镜像

使用这些镜像前，请确保系统已安装Docker。

启动Valentina Server实例

默认情况下，Valentina Server监听以下端口的连接：

• *** - Valentina
• *** - Valentina SSL
• *** - SQLite
• *** - SQLite SSL
• *** - DuckDB
• *** - DuckDB SSL

要从容器外部连接，需通过-p参数发布这些端口。

启动Valentina Server实例：

$ docker run --name some-vserver -d \
    -p 25432:*** \
    -p 25434:*** \
    -p 25532:*** \
    -p 25534:*** \
    -p 25632:*** \
    -p 25634:*** \
paradigmasoft/valentina-server

其中some-vserver是你想要分配给容器的名称。

通过此显式映射，现在可使用端口25432、25434、25532、25534、25632、25634连接服务器。

Valentina Server镜像将自动从Docker Hub仓库拉取。

注意：在Windows的PowerShell终端中，换行符处理方式不同，命令应如下所示：

$ docker run --name some-vserver -d `
    -p 25432:*** `
    -p 25434:*** `
    -p 25532:*** `
    -p 25534:*** `
    -p 25632:*** `
    -p 25634:*** `
paradigmasoft/valentina-server

或者，您可以使用Docker Desktop应用可视化创建和管理容器。

从Valentina Studio连接Valentina Server

!Valentina Studio连接对话框

点击起始页上的连接到... 按钮，选择Valentina Server，并输入以下参数：

• 主机 = 127.0.0.1 或 localhost
• 端口 = <映射到***的端口>
• 用户 = sa
• 密码 = sa

确保取消勾选使用通知选项，因为它需要额外步骤。

要连接Valentina SQLite Server，选择SQLite Server作为目标，并输入以下参数：

• 主机 = 127.0.0.1 或 localhost
• 端口 = <映射到***的端口>
• 用户 = sa
• 密码 = sa

添加许可证

无许可证时，Valentina Server仅允许一个并发连接。
您可获取免费许可证，提供：

• 5个Valentina DB连接
• 5个DuckDB连接
• 10个SQLite连接
• 10个REST连接

或者，您可从Paradigma Store购买具有更多连接数的许可证。

更多详情，请参见许可证文档。

许可证文件格式

许可证文件名可使用以下格式：

• Linux系统 – license_lin_dddddd
• 通用嵌入式 – license_emb_dddddd

默认许可证位置

默认情况下，许可证存储在容器的以下文件夹中：
/opt/VServer/licenses

此位置可通过INI文件中的LicenseCatalog选项修改。

提供许可证的方式

获取许可证文件后，可通过以下方式之一传递给Valentina Server：

• 从主机系统挂载许可证文件夹
• 通过Valentina Studio上传许可证
• 使用docker cp命令将许可证复制到容器

服务器启动后，许可证将自动应用。

挂载许可证文件夹

将许可证下载到主机系统的空文件夹中（例如/VSERVER_DATA/licenses）。

您可将此文件夹挂载到容器的许可证文件夹：

$ docker run --name some-vserver -d \
    --mount type=bind,source=/VSERVER_DATA/licenses,target=/opt/VServer/licenses \
    paradigmasoft/valentina-server

或者，您可挂载单个许可证文件：

$ docker run --name some-vserver -d \
    --mount type=bind,source=/VSERVER_DATA/licenses/license_lin_dddddd,target=/opt/VServer/licenses/license_lin_dddddd \
    paradigmasoft/valentina-server

此方法推荐用于生产环境，可简化容器更新同时保持许可证在主机系统上。

注意： 在macOS上，必须共享挂载的文件夹。

通过Valentina Studio上传许可证

连接到Valentina Server。

有三种上传许可证的方式：

1. 拖放许可证文件到服务器连接上。

2. 上下文菜单： 右键单击连接，选择上传许可证...，并选择许可证文件。

!Valentina Server连接菜单

3. 服务器管理： 从应用主菜单的工具子菜单中打开服务器管理，切换到许可证选项卡，使用上传... 按钮选择许可证文件，或将许可证文件拖到列表中。

!Valentina Server许可证列表

复制许可证到容器

可使用docker cp命令轻松添加许可证。
导航到主机系统上包含许可证的目录并执行：

$ docker cp license_lin_dddddd some_vserver:/opt/VServer/licenses

添加许可证后，确保重启容器。

使用Valentina Server配置文件

Valentina Server配置在INI文件中定义。
默认情况下，它存储在容器中的：

/opt/VServer/vserver.ini

您可能需要调整此配置以满足需求，例如启用REST接口。

修改INI文件的方式

• 使用文本编辑器手动修改。
• 使用Valentina Studio – 在连接属性中或通过服务器管理。
• 使用Valentina ADK – 通过SQL查询或API调用。
• 通过Valentina Server REST接口执行SQL查询。

从主机挂载自定义INI文件

与许可证类似，您可从主机系统挂载INI文件。
将调整后的配置放在/VSERVER_DATA中，并运行：

$ docker run -d --name some-vserver \
    -p 25432:*** \
    -p 25532:*** \
    --mount type=bind,source=/VSERVER_DATA/vserver.ini,target=/opt/VServer/vserver.ini \
    paradigmasoft/valentina-server

此方法简化升级和配置管理。

注意： 在macOS上，必须共享包含挂载文件的文件夹。

启用通知

Valentina Server中的通知机制允许订阅的客户端发送和接收文本消息。消息将传递给所有订阅特定通知通道的客户端。此外，服务器会发送有关架构更改的通知。

默认情况下，通知处于禁用状态。要启用，在INI文件中为Port_NOTIFICATION选项赋值：

Port_NOTIFICATION=25436

或者，您可执行SQL查询（例如在Valentina Studio的SQL编辑器中）：

SET PROPERTY "PORT_NOTIFICATION" OF SERVER TO 25436

重启容器后，新值将生效。

然后可发布和映射通知端口：

$ docker run --name some-vserver -d \
    -p 25432:*** \
    -p 25436:25436 \
    paradigmasoft/valentina-server

要在Valentina Studio中使用通知，映射配置中指定的相同端口（-p 25436:25436）并在连接时启用使用通知选项。

Valentina Server数据存储位置

默认情况下，Valentina Server数据（数据库、项目、许可证、配置）存储在容器内部。虽然对用户透明，但这会使从主机工具和应用访问文件变得困难，并使容器版本间的升级复杂化。

更好的方法是在主机系统上创建数据目录并将其挂载到容器中。这确保数据库文件和项目位于主机上的已知位置，简化访问和升级。您必须确保目录存在，并且权限和安全设置配置正确。

容器中的默认文件夹

• /opt/VServer/databases
• /opt/VServer/sqlite_databases
• /opt/VServer/projects

主机目录示例

• /VSERVER_DATA/databases
• /VSERVER_DATA/sqlite_databases
• /VSERVER_DATA/projects

启动带有挂载数据的容器

基本挂载：

$ docker run -d --name some-vserver \
    -p 25432:*** \
    -p 25532:*** \
    --mount type=bind,source=/VSERVER_DATA/databases,target=/opt/VServer/databases \
    --mount type=bind,source=/VSERVER_DATA/projects,target=/opt/VServer/projects \
    --mount type=bind,source=/VSERVER_DATA/sqlite_databases,target=/opt/VServer/sqlite_databases \
    paradigmasoft/valentina-server

许可证在容器外部：

$ docker run -d --name some-vserver \
    -p 25432:*** \
    -p 25532:*** \
    --mount type=bind,source=/VSERVER_DATA/licenses,target=/opt/VServer/licenses \
    --mount type=bind,source=/VSERVER_DATA/databases,target=/opt/VServer/databases \
    --mount type=bind,source=/VSERVER_DATA/projects,target=/opt/VServer/projects \
    --mount type=bind,source=/VSERVER_DATA/sqlite_databases,target=/opt/VServer/sqlite_databases \
    paradigmasoft/valentina-server

通过此设置，升级服务器只需删除旧容器并创建新容器。

在macOS上挂载

在macOS上，挂载到Docker容器的任何文件夹都必须共享。

转到Docker Desktop菜单 > 偏好设置 > 文件共享，添加要共享的文件夹：

!Docker文件共享

共享文件夹的所有子目录会自动共享。

从Valentina ADK连接Valentina Server

您可使用Linux、macOS和Windows上可用的多种API和IDE中的原生库或插件访问Valentina Server：

• C
• C++
• Objective-C（macOS）
• Objective-C（iOS）
• COM（Windows）
• Java
• LiveCode（Revolution）
• .NET（Windows）
• PHP
• Python
• Ruby
• Xojo（REALbasic）

每个ADK都实现VConnection类，该类接受以下连接参数：

VConnection( 	
    inHost as String, 
    inUserName as String, 
    inUserPassword as String, 
    inPort as Integer = ***,
    inTimeOut as Integer = 5,
    inOptions as String = "" ) 

其中：

• inHost – 主机的IP地址或DNS名称。
• inUserName – 用户名（默认_sa_）。
• inUserPassword – 用户密码（默认_sa_）。
• inPort – 转发到Valentina Server容器的端口。
• inTimeOut – 等待服务器响应的超时时间（秒）。
• inOptions – 附加选项字符串（嵌入式签名）。

此连接适用于Valentina、SQLite和DuckDB数据库。

有关ADK的更多信息，请参见此处。

技术支持

您可在Paradigma Software论坛上提问有关Valentina Server的问题。

我们使用流行的MANTIS开源bug跟踪系统来跟踪功能请求、改进和问题。
提交请求前，请检查跟踪器是否存在以下情况：

• 某些功能未按预期工作。
• 某些功能可改进。
• 您有可使产品更有用或更高效的功能想法。

虽然团队不能保证每个请求都会实现，但我们会考虑通过MANTIS服务器提交的每个请求。

文档

了解更多关于Valentina Server的信息此处。