最新历史版本 :连接本地数据源 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

通过本地宝,本地数据源支持获取多方数据:

  • 支持连接 本地文件夹,自动上传文件夹内的数据,并且实现自动追加文件夹内的数据为一张表,无需手动维护。

  • 支持连接 数据库,获取本地数据库中的数据。

  • 支持连接 百度网盘,获取网盘中的数据,且能实现多人协作维护文件夹数据。

  • 支持连接 WPS 云盘,获取 WPS 云盘中的数据,且能实现多人协作维护文件夹数据。

本文将介绍如何连接本地数据源,请用户按照步骤进行配置。

2. Windows 和 Mac 操作步骤编辑

2.1 下载本地宝

1)从下表中下载适合自己操作系统的本地宝,并安装:

操作系统下载地址
Windows 64位(推荐)

下载链接

mac下载链接

2)安装完成后,请根据接下来的步骤连接本地数据源。

2.2 连接本地数据源

1)进入数据连接市场,选择「本地数据源」。如下图所示:

Group 2.png

2)可以自定义数据连接的名称,方便之后查看。如下图所示:

Group 3.png

3)选择节点,点击「复制配置信息」按钮。如下图所示:

Group 4.png

4)若使用 2.1 节链接下载的本地宝,直接打开本地宝即可,进入 5)。

若使用的是老版本升级后的本地宝,打开本地宝后,需要点击页面打开浏览器,在浏览器中进行配置。如下图所示:

Group 5.png

5)点击左上角的设置按钮,点击「从剪贴板导入」,这样可以直接导入 config.yaml 文件中的配置内容。如下图所示:

注:请确认数据源标识是否与数据源节点右侧的本地宝 ID  是否一致,不一致的话请回到产品中重新点击「复制配置信息」按钮,再粘贴信息。

Group 6.png

6)若连接成功,下方则提示已连接 XXXXX。如下图所示:

Group 7.png

3. Linux 操作步骤编辑

3.1 下载并安装本地宝

直接在 Linux 中执行如下命令进行下载:

wget https://qfx-market.oss-cn-hangzhou.aliyuncs.com/agent/unix_%E6%9C%AC%E5%9C%B0%E5%AE%9D_3_0_0.sh

2025-12-05_09-28-59.jpg

下载完成后,在 Linux 中执行如下命令安装本地宝:

注:若没有权限,则需要使用命令 chmod +x unix_本地宝_3_0_0.sh。

./unix_本地宝_3_0_0.sh

安装完成后在/opt 目录下存在本地宝目录:

2025-12-05_09-45-59.jpg

或者使用带桌面的系统中下载 Linux 版本的本地宝并安装:

操作系统下载地址
Linux

下载链接

3.2 启动本地宝

进入/opt/本地宝目录后,根据 Linux 系统中有无桌面可分为:

  • 有桌面:和 Windows 相同,直接执行 agent.sh 即可;

  • 无桌面:执行 agent-service.sh。

cd /opt/本地宝         #  转到本地宝目录下

./agent               # 有桌面启动,要关闭直接在软件页面关闭即可

./agent-service start # 无桌面启动

./agent-service stop  # 无桌面关闭

2025-12-05_09-45-59.jpg

查看 agent-service 的常用命令,执行 ./agent-service 即可:

./agent-service

3.3 方法一:修改文件直接配置本地宝Config

用户初使用本地宝时通常需要新增数据源,新增数据源的配置存放在/opt/本地宝/config/config.yaml中,因此系统若无桌面,直接修改config.yaml也能达到相同效果。

  • 有桌面:在本地宝页面上操作,详情参见本文 2.2 节;

  • 无桌面:建议在有桌面的电脑下载本地宝配置好数据源、连接到九数云后再将 config.yaml 复制到 Linux 中进行替换。一般情况需要替换的是 server和 datasource。

server:从九数云本地数据源上复制配置,替换 agentId、token 和 host。

datasource:要连接的各种类型的数据源配置。

注:配置 config.yaml 需要保证其 YAML 格式。

示例数据:

server:
  protocol: "https"
  port: 443
  version: "v4.0"
  agentId: "98ccd999bd56457c96701c63f8b8f77f"
  token: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhZ2VudElkIjoiOThjY2Q5OTliZDU2NDU3Yzk2NzAxYzYzZjhiOGY3N2YiLCJpc3MiOiJmYW5ydWFuIiwidGVuYW50SWQiOiJlYjFiZDY2MjE1OTA0NzU1ODA2YTJkMjk0ZmJhZGQyNSIsImlhdCI6MTc2MzU1NDQ0NSwianRpIjoieFMzOG1HY3NReUVUODBHWmtzNE5IRUQ4dWtOd00yMWdLL1lLN2gzMjVCdGpPYUN0In0.dB5Dx4ff4-MO1amF_0FrZJ0cqSX77kFiWTk_2Qggl6U"
  host: "agent.jiushuyun.com"
datasource:
  - watchInterval: 3
    key: "local-示例数据(可删除)" 
    sourceName: "file"
    type: "local"
    concurrent: 5
    directoryPath: "/root/file"
    relative: true
    tables: []
    autoTables: {}
    strategy: 1
socket.io:
  reconnectionAttempts: 0
  reconnectionDelay: 1000
  timeout: 20000

将配置信息下对应的信息写入文件中,然后设置 datasource 配置。

2025-12-05_16-30-12.jpg

验证本地宝连接成功:

在九数云页面打开对应本地数据源,查看本地宝配置的数据源是否已展示出来,是则成功,否则检查上述步骤。

2025-12-05_16-34-26.jpg

3.4 方法二:无桌面服务器使用页面配置Config

如果有服务器的控制权限,无桌面的 Linux 系统运行本地宝后也可通过页面配置。

在有桌面的电脑上执行 ssh,将本地 8001 和 8002 端口流量转发到 Linux 系统;

ssh -L 8001:localhost:8001 <user>@<remote-IP>
ssh -L 8002:localhost:8002 <user>@<remote-IP>

开启两个终端窗口并分别执行上面两条命令,示例如下:

2025-12-05_16-47-33.jpg

注:默认情况下本地宝使用 8001 和 8002 端口。当服务器的 8001 或 8002 端口被占用时,需要检查本地宝实际使用的端口再进行端口放行。

要查看实际使用的端口,执行如下命令:

ps -ef | grep 本地宝  # 查找对应进程

#返回信息
root     3911531       1  6 17:01 pts/0    00:00:14 /opt/本地宝/jre/bin/java -Xmx1024m -Xms256m -classpath /opt/本地宝/.install4j/i4jruntime.jar:/opt/本地宝/.install4j/launcherddbb6e95.jar:/opt/本地宝/lib/* install4j.com.fanruan.opensource.FineDatabaseAgent3720048277 start
root     3914296 3849313  0 17:05 pts/0    00:00:00 grep --color=auto 本地宝

lsof -p 3911531 -nP | grep LISTEN
#返回信息
java    3911531 root   18u     IPv6          404246809       0t0       TCP 127.0.0.1:42279 (LISTEN)
java    3911531 root   98u     IPv6          404246465       0t0       TCP 127.0.0.1:8002 (LISTEN)
java    3911531 root  101u     IPv6          404246925       0t0       TCP *:8001 (LISTEN)

访问本地宝网页:

在有桌面的另一台电脑的浏览器上访问localhost:8001/web,即可打开本地宝的网页。

2025-12-05_16-56-05.jpg

首次注册填写用户名密码即算注册成功,输入后即可进入本地宝配置界面

2025-12-05_17-03-23.jpg

4. 下一步编辑

1)以上操作是准备工作,先连接好本地数据源,下一步,可以在本地宝中连接本地文件夹、连接本地数据库、连接百度网盘等等,连接好后,数据就会自动同步到产品中。

详情参见文档:连接本地文件夹连接本地数据库连接百度网盘多人协作维护本地数据源

2)在连接时,请注意以下内容:

  • 一台电脑仅支持开启一个本地宝;

  • 一个本地宝仅支持连接一个企业;

  • 一个企业中可以新增多个本地数据源连接,每个数据连接都可以连接一个本地宝。因此,一个企业,可以连接多个本地宝。