1. 概述
通过本地宝,本地数据源支持获取多方数据:
支持连接 本地文件夹,自动上传文件夹内的数据,并且实现自动追加文件夹内的数据为一张表,无需手动维护。
支持连接 数据库,获取本地数据库中的数据。
支持连接 百度网盘,获取网盘中的数据,且能实现多人协作维护文件夹数据。
支持连接 WPS 云盘,获取 WPS 云盘中的数据,且能实现多人协作维护文件夹数据。
本文将介绍如何连接本地数据源,请用户按照步骤进行配置。
2. Windows和Mac操作步骤
2.1 下载本地宝
1)从下表中下载适合自己操作系统的本地宝,并安装:
| 操作系统 | 下载地址 |
|---|---|
| Windows 64位(推荐) | |
| mac | 下载链接 |
2)安装完成后,请根据接下来的步骤连接本地数据源。
2.2 连接本地数据源
1)进入数据连接市场,选择「本地数据源」。如下图所示:

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

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

4)若使用 2.1 节链接下载的本地宝,直接打开本地宝即可,进入 5)。
若使用的是老版本升级后的本地宝,打开本地宝后,需要点击页面打开浏览器,在浏览器中进行配置。如下图所示:

5)点击左上角的设置按钮,点击「从剪贴板导入」,这样可以直接导入 config.yaml 文件中的配置内容。如下图所示:
注:请确认数据源标识是否与数据源节点右侧的本地宝 ID 是否一致,不一致的话请回到产品中重新点击「复制配置信息」按钮,再粘贴信息。

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

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

下载完成后,在 Linux 中执行如下命令安装本地宝:
注:若没有权限,则需要使用命令 chmod +x unix_本地宝_3_0_0.sh。
./unix_本地宝_3_0_0.sh
安装完成后在/opt 目录下存在本地宝目录:

或者使用带桌面的系统中下载 Linux 版本的本地宝并安装:
| 操作系统 | 下载地址 |
|---|---|
| Linux |
3.2 启动本地宝
进入/opt/本地宝目录后,根据 Linux 系统中有无桌面可分为:
有桌面:和 Windows 相同,直接执行 agent.sh 即可;
无桌面:执行 agent-service.sh。
cd /opt/本地宝 # 转到本地宝目录下
./agent # 有桌面启动,要关闭直接在软件页面关闭即可
./agent-service start # 无桌面启动
./agent-service stop # 无桌面关闭

查看 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 配置。

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

3.4 方法二:无桌面服务器使用页面配置Config
如果有服务器的控制权限,无桌面的 Linux 系统运行本地宝后也可通过页面配置。
在有桌面的电脑上执行 ssh,将本地 8001 和 8002 端口流量转发到 Linux 系统;
ssh -L 8001:localhost:8001 <user>@<remote-IP>
ssh -L 8002:localhost:8002 <user>@<remote-IP>
开启两个终端窗口并分别执行上面两条命令,示例如下:

注:默认情况下本地宝使用 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,即可打开本地宝的网页。

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

4. 下一步
1)以上操作是准备工作,先连接好本地数据源,下一步,可以在本地宝中连接本地文件夹、连接本地数据库、连接百度网盘等等,连接好后,数据就会自动同步到产品中。
详情参见文档:连接本地文件夹、连接本地数据库、连接百度网盘、多人协作维护本地数据源
2)在连接时,请注意以下内容:
一台电脑仅支持开启一个本地宝;
一个本地宝仅支持连接一个企业;
一个企业中可以新增多个本地数据源连接,每个数据连接都可以连接一个本地宝。因此,一个企业,可以连接多个本地宝。
