diff --git a/docs/content/docs/cli.cn.mdx b/docs/content/docs/cli.cn.mdx index deec31dad2..7740072a4d 100644 --- a/docs/content/docs/cli.cn.mdx +++ b/docs/content/docs/cli.cn.mdx @@ -7,6 +7,8 @@ description: 使用原生 DBX CLI 在终端、脚本、CI 和 Codex 中读取连 ## 安装 +### npm + ```bash npm install -g @dbx-app/cli ``` diff --git a/docs/content/docs/driver-management.cn.mdx b/docs/content/docs/driver-management.cn.mdx index 455c95a5d5..5fd1df6795 100644 --- a/docs/content/docs/driver-management.cn.mdx +++ b/docs/content/docs/driver-management.cn.mdx @@ -85,7 +85,7 @@ RabbitMQ 等消息队列 Agent 还可能同时使用业务协议和管理 API。 所有 Agent 都提供单驱动 ZIP，可直接使用**导入离线包**安装。Java Agent 的单驱动包跨平台，但不重复携带 JRE；KingbaseES、Oracle、Xugu 等原生 Agent 的单驱动包按操作系统和 CPU 架构区分。 -如果目标机器尚未安装 Java Agent 所需的托管 JRE，可在**导入离线包**中选择对应平台的 `dbx-jre-21-.tar.zst`，或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时，不包含数据库驱动，也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。 +如果目标机器尚未安装 Java Agent 所需的托管 JRE，可在**导入离线包**中选择对应平台的 `dbx-jre--.tar.zst`（例如 `dbx-jre-21-macos-aarch64.tar.zst`），或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时，不包含数据库驱动，也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。 ### Windows 导入 KingbaseES @@ -93,6 +93,12 @@ Windows x64 下载 `dbx-agent-kingbase--windows-x64.zip`，Windows ARM6 ZIP 内包含版本信息和对应平台的原生 Agent。DBX 会将其安装为 `%USERPROFILE%\.dbx\agents\drivers\kingbase\agent.exe`，不需要手动解除浏览器下载文件的阻止状态或复制文件。 +### 离线导入 JDBC 插件 + +通用 JDBC 连接（自定义 JDBC URL + 导入的驱动 JAR）通过独立的 **DBX JDBC 插件** 运行，发布为单独的 `dbx-jdbc-plugin-*.zip` 资源，**不会**打进各数据库的 Agent ZIP。请在 **JDBC 驱动** 页签使用 **本地安装** 安装它（不要用内置驱动里的**导入离线包**，那是给 Agent ZIP 用的）。 + +导入真正的驱动 JAR（例如 Oracle 的 `ojdbc*.jar`）始终是本地操作，不需要这个插件包，也不需要网络——在同一页签使用 **导入 JAR**，无论 JDBC 插件本身是否已安装。 + ## 插件更新 对于由 [JDBC 插件](/cn/docs/plugins)支持的数据库，当有新插件版本可用时，DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。 diff --git a/docs/content/docs/driver-management.mdx b/docs/content/docs/driver-management.mdx index 8a98744632..03fbee7e72 100644 --- a/docs/content/docs/driver-management.mdx +++ b/docs/content/docs/driver-management.mdx @@ -85,7 +85,7 @@ This is useful for air-gapped networks, strict firewall environments, or pre-app Every agent provides a single-driver ZIP that can be installed with **Import offline package**. Java agent packages are platform-independent and do not duplicate the JRE, while native agents such as KingbaseES, Oracle, and Xugu provide separate packages for each OS and CPU architecture. -If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre--.tar.zst`, or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation. +If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre--.tar.zst` (for example `dbx-jre-21-macos-aarch64.tar.zst`), or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation. ### Importing KingbaseES on Windows diff --git a/docs/content/docs/getting-started.mdx b/docs/content/docs/getting-started.mdx index f6fb28f9e1..456b646a94 100644 --- a/docs/content/docs/getting-started.mdx +++ b/docs/content/docs/getting-started.mdx @@ -59,6 +59,12 @@ This guide gets you through three things: flatpak update com.dbxio.dbx ``` + On Kylin V10, UnionTech UOS, and similar Chinese desktop distributions, install from the [Spark App Store](https://spk-resolv.spark-app.store/?spk=spk://store/development/dbx) and choose the **APM build**. AmberPM provides a compatible runtime that reduces install/startup failures caused by distro dependency drift; updates are also available from the Spark App Store client. + + + The APM build runs DBX inside that compatibility runtime. If you select the host Java for Agent/JDBC drivers, prefix the path with `/host` — enter `/host/usr/bin/java` instead of `/usr/bin/java`. + + You can also download a package from [GitHub Releases](https://github.com/t8y2/dbx/releases): | Format | Use Case |