Mybase Server for Linux/macOS/Windows

软件支持创建一个或多个数据库，每个数据库对应生成一个 .nyf 文件，其中以树形大纲形式存储用户输入的各项资料内容，每个大纲条目可存储一篇文本内容，同时可存储一个或多个附件文档或图片； 不同大纲条目之间可建立双向链接相互关联；支持自定义标签，可对大纲条目再次进行分类；下面知识库内部信息组织结构示意图可供参考：

本地磁盘文件系统 | +--Mybase 数据库 (*.nyf 文件) | +--大纲条目（树形结构，无限层级） | | | +--虚拟条目（类似于指针或符号连接，指向其它条目） * | | | +--信息条目（包含具体知识内容） | | | +--缺省文档内容 (*.html/txt/md) | | | +--附件文档（*.*） | | | | | +--图片（*.jpg/gif/bmp/png ...） | | | | | +--文档（*.docx/xlsx/pptx/pdf/html/md ...） | | | | | +--快捷方式（链接到外部文档）* | | | | | +--其它文件（*.exe/bin/dat...） | | | +--关联条目（相关联的条目） | | | +--线索条目（源自文档中线索标记 [[ keywords ]] ）* | | | +--关联标签（二次分类） | +--标签条目（树形结构，无限层级） | | | +--标签1（标记的大纲条目 ...） | | | +--标签2（标记的大纲条目 ...） | | | +--标签3（标记的大纲条目 ...） | | | +--更多 ... | +--自定义图标（信息条目的关联图标）* | +--日历（信息条目的关联日期）* | +--书签（信息条目的书签标记）* | +--保存的搜索项 * * 仅适用于桌面版，网络版暂不支持

Mybase Server 基本使用方法

运行方式和配置说明：Mybase Server 设计为独立的网络服务器程序，可运行于 Linux/macOS/Windows 桌面电脑或服务器系统中，客户端可使用常用浏览器软件（Chrome/FireFox/Safari/Edge等）通过公网/私网/局域网连接服务器程序访问数据库内容，或者也可仅于本机（localhost）内部使用； 根据不同应用场景和网络环境，具体安装配置方法可能有所不同，如下：

1. 如需在桌面电脑或服务器电脑本机内部使用，可先 安装服务器程序，然后在本机电脑中使用浏览器软件打开链接 http://localhost:8082 即可，不需要额外网络环境配置等操作。
2. 如需在公司部门或家庭内部私有局域网中允许多台电脑同时接入服务器，可先在局域网服务器电脑中 安装服务器程序，然后使用浏览器软件打开链接 http://IP:8082 ，其中 IP 须替换为服务器主机名称或其 IP 地址（参见：如何查看服务器 IP 地址）。
3. 如需通过公网使用 Mybase Server，除了正确安装服务器程序外，可能还需根据具体网络环境作进一步配置/设置，如下：
   • 如果服务器电脑已有公网 IP 地址，或已租有独立主机或 VPS 虚拟服务器，可在服务器电脑中 安装服务器程序，然后使用浏览器软件打开链接 http://IP:8082 ，其中 IP 须替换为服务器主机名称或其 IP 地址（参见：如何查看服务器 IP 地址）。
   • 如果服务器电脑没有公网 IP 地址，比如家庭内部电脑，则除了先在服务器电脑中 安装服务器程序 外，可能还需要作进一步网络环境配置（比如：内网穿透），才能通过公网接入访问内部服务器；安装配置完成后，使用浏览器软件打开链接 http://IP:PORT 其中 IP 须替换为内网穿透配置的服务器域名或其 IP 地址，PORT 须替换为内网穿透配置的对应端口。
   • 通过公网使用 Mybase Server 可能涉及较多配置步骤，需要对网络配置有一些初步了解；相对于配置内网穿透，直接使用自有公网服务器或租用 VPS 虚拟主机可能有助于简化一些配置操作。

安装服务器端软件：不同系统平台的服务器安装方式不完全相同，Mybase Server 安装包中分别提供了相应系统平台的安装程序或脚本， 通常直接运行即可以默认选项将 Mybase Server 安装到系统中作为一项系统后台服务程序，服务器电脑开机即可自动启动运行； 如果希望自定义某些安装选项，比如数据库目录位置、日志文件目录位置以及监听 IP 地址和 TCP 端口号等，可在安装/配置过程中更改需要定制的选项； 详见：服务器端安装方法； 如果希望使用 https 安全链接访问数据库，可参见 http/https 反向代理相关说明； 如果希望从公网访问内网/家中数据库，可参见 tcp 端口转发/内网穿透相关说明。

免安装客户端软件：Mybase Server 提供通用 Web 浏览器界面，客户端不需要额外安装/部署任何软件，使用目前常见的浏览器（Chrome/FireFox/Safari/Edge等）打开服务器所在网址即可， 网址类似这样：http://xxx:8082 其中 xxx 需替换为服务器主机外部网卡 IP 地址或者相应域名，其中 8082 为默认端口号，如果安装时选择其它端口号，则需相应替换到网址中.

管理员 Web 界面：服务器安装完成后，默认登录帐户为 admin，密码留空，需及时登录进入管理员界面 http://xxx:8082/admin 设置管理员帐户密码， 然后根据需要创建数据库，添加用户/组帐户并配置访问权限，详见：使用说明文档

客户端 Web 界面：在服务器端安装完成后，可在客户端电脑浏览器中以默认 admin 帐户或自行添加的其他用户帐户/密码登录进入编辑界面：http://xxx.8082/edit 或查看界面：http://xxx:8082/view 即可开始使用; 与 Mybase Desktop 8.x（桌面版）界面操作方式类似，客户端编辑/查看 Web 界面也采用简洁明了的三栏布局，顶部工具栏中可选择切换当前数据库、设置语言/界面主题等相关操作； 在左边树形大纲视图中（Outline）可根据需要添加信息条目（Info Items），每个条目可以保存一篇图文混排或纯文字内容的缺省文档（格式可为 HTML网页、纯文本、或 Markdown 三种内置可选格式之一）， 以及一组任意类型的附件文件（Attachments）； 若任意两个条目间存在某种关联，则可以为这两个条目创建双向链接（Item Links），通过该链接可以快速从一个条目跳转到相关联的另一个条目； 此外，树形多级标签（Label Tree）为信息条目提供了另一种形式的自定义分类方式，可以创建任意层次的标签树， 并为任意条目指定多重标签，在标签列表中点击标签条目即可查询并逐个列出关联条目。

大纲条目内容浏览优先规则：当点击树形大纲中任意信息条目， Mybase 按如下优先规则展现条目中的首选内容：当条目包含了格式为 HTML/Rich/Plain/Markdown 四种格式之一的缺省内容， 则首先显示该条目的缺省内容；若条目没有包含缺省内容，则会自动在该条目的附件列表中寻找第一个可以打开查看/编辑的附件文档， 通常是按如下文档类型优先顺序匹配：html > qrich > txt > md，当找到匹配的附件文档后，就会尝试下载并在内容视图中打开； 如果该条目没有任何内容可查看或编辑，则在内容视图中会提示创建当前条目缺省内容的格式选项，选定 HTML/Plain/Markdown 三种格式之一即可进入相应文档格式的编辑状态，并接受相应格式的内容输入。

客户端主要操作方式：对于一般日常例行使用，操作方式大致如此：添加信息条目 - 编辑条目内容 - 整理/关联/分类条目 - 搜索/查看/分享内容。

如何更有效运用 Mybase Server 软件

不同用户可能会有不同的仅适合自己的信息分类/组织/管理方式，Mybase Server 实现的多维信息组织分类方式（树形大纲、树形标签、条目关联、附件存储、内部链接等）可提供一定的灵活性和便利性； 使用 Mybase Server 管理个人或团队知识资料库通常会涉及以下几个方面要点：

• 规划信息内容：可按资料/信息类别分别创建不同的数据库（.nyf 文件）中，即：每个库保存一个类别的资料/信息内容， 比如：客户资料管理.nyf、产品信息管理.nyf、工作日志.nyf、生活日记.nyf、学习笔记.nyf、网络文摘.nyf、投资管理.nyf、帐户密码管理.nyf、专题xxx知识库.nyf 等等； Mybase Server 中配置的用户/组访问权限作用于单个数据库，因此更细化的数据库分类可使访问权限管理更精细化一些。
• 快速构建数据库或知识库：对于磁盘中现有资料/信息内容（如：文档/图片/网页/邮件等），除了手动逐项创建条目并上传到服务器中保存， 还可以借助 Mybase Desktop 8.x 软件提供的各项本地数据导入工具，快速构建相应的 .nyf 数据库，并加以必要的组织分类或格式适配调整； 然后将生成的 .nyf 库文件迁移到网络版库存储目录中即可继续使用； 关于 Mybase Desktop 导入工具的使用方法，详见说明文档。
• 信息内容的增补与更新：客户端界面中允许随时对数据库内容进行增补、修订、更新、删除等操作； 对于网上浏览到的精彩内容，可直接复制/粘贴，或借助 WebCollect 浏览器扩展插件将网页或其中选定部分内容抓取复制到剪贴板中，然后粘贴到内容编辑器并保存到数据库中； 在日常工作/学习/生活中，可将每天重要事情/日志/计划/笔记/日记/心得感悟/备忘录等信息及时保存到数据库中。
• 快速查找信息：可在客户端界面上方的搜索框中键入关键词并按 Enter 键开始查询；查询语句支持布尔操作符 [AND, OR, NOT] 及其助记符 [ &, |, ! ]；例如：查询 "ABC | XYZ" 等价于 "ABC or XYZ"；
• 分享信息：每个信息条目均设置有一项对应的 http 链接地址，通常会显示在内容视图上方地址栏中，点击可在当前浏览器新页面中打开对应条目内容； 如果其他用户拥有该数据库的访问权限，通过该链接地址即可分享查看到其内容；如果希望将条目内容分享给其他任意/匿名用户，则需要事先由管理员在服务器管理界面中开启匿名用户访问选项，并配置匿名用户对该数据库的访问权限。 如果希望以其它常见文档格式分享内容，比如 HTML、CHM、ePub、TXT、HtmlTree、Markdown、PDF 等，可尝试借助 Mybase Desktop 8.x（桌面版）提供的常见文档格式导出工具，详见说明文档。
• 保障数据库的安全：对于精心组织构建的个人数据库或知识库，须确保数据库安全性，特别是重要的数据内容，须定期 备份数据库， 以防存储设备故障、断电停机、操作失误等意外情况导致数据丢失。

如何从浏览器中抓取网页内容和图片

从浏览器中保存网页内容到数据库中是一项常见的操作，根据不同网站页面布局方式和资源存取策略，可分别尝试以下几种方法抓取网页内容：

Ctrl+C 和 Ctrl+V：客户端界面中支持网页内容编辑，可直接从浏览器中复制/粘贴网页内容到编辑器中；

WebCollect 浏览器插件：除了直接复制/粘贴外，可考虑安装 WebCollect 浏览器扩展插件； 利用该扩展插件可将整个网页或选定部分抓取并复制到系统剪贴板中，然后可粘贴到当前内容编辑器中；

WebCollect 最新版本支持 Firefox/Chrome 浏览器，且跨系统平台通用，支持 Linux, macOS, Windows 三个主流桌面系统平台。 注：根据现代浏览器的安全策略要求，安装方法需遵照如下操作步骤：

• 针对 Firefox 浏览器，可在 Mybase 中选择 Tools - Install Webcollect host for Firefox 菜单，然后根据指引，在 Firefox 浏览器中打开Firefox 扩展应用商店， 将 Webcollect 扩展插件添加到 Firefox 浏览器中即完成安装。
• 针对 Chrome 浏览器，可在 Mybase 中选择 Tools - Install Webcollect host for Chrome 菜单，然后根据指引，在 Chrome 浏览器中打开Chrome 扩展应用商店， 将 WebCollect 扩展插件添加到 Chrome 浏览器中即完成安装。
• 安装成功后，在浏览器中会自动添加上 [Save with Mybase] 命令 ( 快捷键：Alt+Shift+S )，用于抓取当前页面内容或选定内容（包括图片、格式等），并直接发送到 Mybase Desktop 当前数据库中； 另一项功能 [Copy Html + Images] ( 快捷键：Alt+Shift+C )，用于将当前页面内容或选定内容（包括图片、格式等）复制到系统剪贴板中，但不发送到 Mybase Desktop 当前数据库中，随后可在内容编辑器中粘贴内容； 该命令加强了浏览器本身提供的复制功能，图片和样式表等会尝试嵌入到抓取的内容中，保存到数据库中后仅生成单一 html 附件文件，便于查阅和管理； 不过需注意，当网页中包含大量图片数据并全部嵌入，可能会导致 html 源码内容迅速膨胀，在客户端界面中查看/编辑时可能需要耗费更长下载/上传时间，可根据实际需要选择是否使用该项功能。

注意：如果需要保存的网页布局/格式复杂，内嵌图片元素多，建议先选取页面中核心内容，排除掉边栏广告等非必要元素，以简化抓取页面片断的格式布局，然后再复制或抓取选中的内容片断，减少无关图片下载和资源耗费，同时提高页面内容抓取成功率。

如何复制/粘贴纯文本内容

在各种应用软件中以 Ctrl+C 复制内容时，通常剪贴板中会包含有一种或多种格式的内容，比如：从常用浏览器或 MS-Office 中复制内容时， 剪贴板中可能会同时包含有网页、文本、图片或网址链接等多种格式的内容，在内容编辑器中直接以 Ctrl+V 命令执行粘贴操作，通常会将文本内容以及格式设置全部贴入； 如果仅需从剪贴板中粘贴纯文字到内容编辑器中，可尝试使用键盘组合快捷键：Ctrl+Shift+V 或 Command+Shift+V。

如何导入本地文档内容或图片

现代浏览器基于 web 平台安全策略通常会禁止脚本程序任意访问本地文件系统或其它软件进程等相关资源；如果需要导入本地文档内容或图片，可尝试手动上传本地文件或图片到附件栏中，然后在文档内容中引用已上传的图片。 如果需要导入较多本地文档内容或图片，可考虑借助 Mybase Desktop（桌面版）提供的多种常见格式数据导入工具，方便快捷的导入本地文件资源或与其它软件进程交换数据内容，当本地内容全部成功导入后再 将 .nyf 数据库迁移到服务器版 以便于通过网络管理分享使用；

如何创建/编辑 Markdown 内容

新建大纲条目时，选择 MD 格式即可创建缺省内容为 Markdown 格式的新条目，并自动进入编辑模式。

对于本地磁盘中现有 .md 文档，可选择 "Attach" 按钮，提交上传为当前条目的附件文档；条目中单一 .md 文档可作为条目的缺省内容。

Markdown 文档格式遵循 CommonMark 0.28 语法规范， 并支持源代码加亮、数学公式、流程图等扩展特性。

查询/搜索相关说明

在客户端界面上方的搜索框中直接键入关键词或查询语句，并按 Enter 键即可开始查询；查询语句支持布尔逻辑操作符 [AND, OR, NOT] 及其助记符 [ &, |, ! ]；例如：查询 "ABC | XYZ" 等价于 "ABC or XYZ"；

服务器端程序基于索引数据实现查询功能，通常添加/编辑/修订条目内容时索引数据会自动同步更新，以确保查询功能随时/即时可用；如果没有索引数据或存在故障，则查询功能会受影响； 在客户端编辑界面中提供了重建索引数据的选项，如果有必要重建索引数据，可选择界面上方 "Action - Index data - Clear/Update" 菜单先清空然后重建索引。

当前版本支持简易的分词方法，可对数据库中包含的英文单词、中文字词等进行索引，该方法的优点是查询响应较为快速，避免过多延缓其他用户操作响应速度，其缺点是对某些过于常用的词语的查询结果过滤不够精确； 如果遇到查询结果不够精确，可适当增加/调整关键词，或运用布尔逻辑操作符，以减少不精确的查询结果。

是否支持索引/搜索 MS-Office/HTML/PDF 文档

当前版本支持 docx, xlsx, pptx, html, txt 和 md 等格式文档内容的解析、索引和搜索，但未内置支持 pdf 文档内容的解析和索引。

如果服务器端程序运行在 Windows 系统中，可尝试事先在系统中安装 PDF IFilter 插件，然后再重建索引数据，借助该插件可实现 pdf 文档内容的解析和索引。 该插件目前可从 Adobe 官方网站下载 或自行寻找其它第三方 PDF IFilter 插件。

如何多重选择大纲条目并进行移动/删除等操作

编辑界面中，树形大纲视图支持多重条目选择，可按住键盘上面 Ctrl 或 Command 键，并点选多个相邻或不相邻的条目，然后选择大纲视图上方 "Action - Location - Move to ..." 菜单项，即可将选定条目移动到其它位置或分枝中， 或者选择 "Action - Info item - Delete ..." 菜单可删除选定条目。

如何放大/缩小界面字体大小

客户端界面基于现代 Web 浏览器平台，缩放界面字体大小最简便的方法是利用浏览器软件内置的缩放工具 [View - Zoom in/out] 或其快捷键 [Ctrl +/-]； 如需更多定制选项，比如色彩/边框等，可参见：如何定制界面主题

如何定制界面主题

客户端界面基于现代 Web 浏览器平台，可通过修订 css 样式属性定制界面字体、色彩、边框等显示风格；客户端界面内置提供有几个不同色彩的界面主题供选择， 可选择界面上方 "Action - User preferences - Theme ..." 菜单，然后选取一个合适的界面主题。

如果希望添加更多自定义界面主题，可在服务器程序安装目录下面 ./themes 子目录中，由现有 .css 模板文件复制生成新的 .css 文件，然后向其中添加/设置自定义的样式属性即可。

如何切换到中文界面

软件内置提供英文和简体中文两个界面语言包，在登录页面中选择简体中文即可；或者成功登录后选择主界面上方 "Actions - User preferences - Language" 菜单进行设置。

如何添加用户帐户并配置访问权限

首先以管理员帐户登录进入管理配置管理界面 [./admin#users]，通过 [New...] 按钮可创建任意多的新用户帐户；新添加的用户此时尚未获得访问授权无法登录，还必须根据情况放入相应权限的用户组中才能获得登录和访问权限； 服务器软件在安装时默认预设了 [administrators, editors, viewers, anonymous] 四个基本权限分组，并分别预置了对应的访问权限配置项；将新添加用户放入其中一个或多个用户组中即获得对应用户组所拥有的全部访问权限。

除了系统预设的四个基本权限分组，还可根据实际需要添加更多自定义的权限分组，并分别配置不同的访问权限；具体地，在 [./admin#groups] 界面中通过 [New...] 按钮添加新的用户组， 然后在 [./admin#privileges] 界面中通过 [New...] 按钮添加新的权限配置项，指派给新建的权限分组，并通过 [Privileges...] 按钮分配所需的权限明细，可具体到每一项操作命令或全开或全禁， 如果设置为（全开），则当前选定的权限分组将具备全部管理功能操作权限； 另外，针对每一个权限配置项，默认未分配任何数据库的访问权限（全禁），可通过 [Databases...] 按钮分配可访问的数据库名称，可设置为全开或全禁或具体分配某一项或多项数据库名称。

如何更改帐户登录密码

对于普通用户帐户，可登录进入查看/编辑界面，选择界面上方 "Action - Password - Change ..." 菜单即可修改当前用户的登录密码； 如果希望重置密码或设置其他用户帐户的密码，则须登录进入管理员界面，然后在用户帐户栏目中重置相应用户帐户的密码。

如何重置帐户登录密码

对于普通用户帐户，如果遗忘登录密码，可联络系统管理员，请求帮助重置密码，重置后再登录进入查看/编辑界面即可自行修改登录密码； 如果管理员帐户密码不慎遗忘，则需要服务器管理员手动修改/清除服务器程序的权限配置文件中相关设置。

如何在桌面版和网络版之间迁移现有数据库

Mybase Server（网络版） 和 Mybase Desktop（桌面版） v7.x/8.x 采用相同的 .nyf 数据库文件格式； 对于在桌面版中创建的 .nyf 数据库文件，如果希望迁移到网络版中使用，可将其放入服务器程序的数据库存储目录中，然后重新开启服务器程序即可； 相反，由网络版创建的 .nyf 数据库文件，如果希望迁移到桌面版中使用，可先停止服务器程序，然后将其库目录中现有 .nyf 文件复制到桌面版数据库所在目录中即可直接在桌面版中打开使用；

注：针对 v8.1b+ 网络版，在 web 浏览器界面 "./admin#databases" 中提供了 [上传] 和 [下载] 功能，不再需要手动操作服务器文件系统中任何文件，可直接在服务器管理界面中将桌面版生成的 .nyf 库文件上传到服务器存储目录中并即刻生效； 相反，也可通过管理员帐户在 Web 浏览器界面 "./admin#databases" 中直接下载选定数据库对应的 .nyf 库文件，然后在桌面版中直接打开下载得到的 .nyf 库文件即可； 相应地 .nyf 库文件伴随的 .dbindex 索引数据文件也同样可直接上传和下载，网络版与桌面版交换数据文件的操作过程从而得到大大简化。

如何备份数据库

备份数据相当重要。尽管软件在数据库安全性可靠性等方面花费了大量资源进行改进，新版本 SSG-5 存储格式也提供了更高的应急恢复能力， 但这些应急措施不能替代主动的数据库备份操作。

备份数据库主要是指备份 .nyf 文件，即：将数据库存储目录中的 .nyf 库文件复制到其它安全可靠的U盘、移动硬盘、网盘或其他任意文件夹中并安全存放保管即可。

在服务器程序运行期间，如果需要在服务器电脑中直接复制备份其存储目录中现有 .nyf 库文件，请事先临时停止服务器程序以解除文件锁定正常关闭库文件，然后再开始备份库文件，待备份操作完成后方可重新开启服务器程序。

注：针对 v8.1b+ 网络版，在 web 浏览器界面 "./admin#databases" 中提供了 [上传] 和 [下载] 功能，不再需要手动操作服务器文件系统中任何文件， 可通过管理员帐户在 Web 浏览器界面中直接下载备份选定数据库对应的 .nyf 库文件和 .dbindex 索引文件。

如何安装服务器程序

Mybase Server 主程序可安装在独立服务器、VPS、桌面电脑或单板电脑等硬件系统中运行，目前支持 Linux_amd64, Linux_aarch64, macOS 和 Windows 7+ x64 系统。针对不同系统平台，安装包分别提供了相应的安装程序，用于将 Mybase Server 安装到系统中，并配置为开机自动启动服务项。

• Linux 系统

  首先将下载得到的服务器程序安装包解开压缩，保存到用户主目录中，可使用桌面解压缩工具软件，或使用如下命令行工具：

  $ cd $ tar xJf Mybase-Server-Ver800b1-Linux-amd64.tar.xz

  解开压缩包后，打开终端窗口，运行其中的安装脚本程序，例如：

  $ cd MybaseServer $ ./Install-Mybase-Server.sh

  该安装脚本默认将 Mybase Server 安装在应用程序目录 "/opt/MybaseServer" 中，相应的 .nyf 数据库文件默认目录位于 "/var/opt/MybaseServer/Repository"，日志文件默认目录位于："/var/opt/MybaseServer/Logs"；

  安装脚本支持定制安装选项，可在安装过程中根据提示信息手动指定服务器程序监听 IP 地址、TCP 端口、以及存储数据库/日志文件的目录位置；

  如果已安装过旧版本，安装脚本会提示确认是否需要覆盖安装；另外在配置系统服务项时可能会提示输入系统管理 sudo 密码，以便授权安装脚本将 Mybase Server 配置为 Systemd/Initd 服务项并自动启动；

  服务器程序以默认选项安装成功后即可在当前服务器电脑系统中使用浏览器打开以下链接进入管理或编辑 Web 界面；

  • http://localhost:8082/welcome
  • http://localhost:8082/admin
  • http://localhost:8082/edit
  • http://localhost:8082/view

  其中 "8082" 为服务器程序默认监听端口，如果安装过程中已作修改/定制，则需替换为相应端口号；若通过网络远程访问服务器，将其中 "localhost" 替换为当前服务器系统外部网络 IP 地址或相应主机名；

  如果当前系统中带有桌面图形界面（KDE/GNOME），安装脚本会尝试添加应用程序图标，便于直接打开 Web 界面，避免需要手动打开浏览器再输入网址链接；

  对于现有 .nyf 数据库，若需要迁移到服务器版中使用，可先将其复制或移动到服务器程序的数据库存储目录 "/var/opt/MybaseServer/Repository" 中，然后通过系统中服务管理界面或终端命令行重新启动 mybaseserver 服务项，例如：

  $ sudo systemctl stop mybaseserver $ sudo systemctl start mybaseserver

  如果过程中出现异常情况，或需实时查看服务器程序日志记录，可在终端窗口中使用 tail 命令，例如：

  $ tail -n 150 -f /var/opt/MybaseServer/Logs/debug_20231001.log

  注：当前 Linux 版服务器程序支持 amd64 和 aarch64 架构芯片，安装脚本支持 Systemd 和 Initd 两种服务管理方式； 针对其它定制类型的 Linux 系统，比如常见的群辉 NAS 存储管理系统，可尝试在控制面板中打开终端机 SSH 登录权限，然后以当前用户名登录后使用 sudo -i 命令进入交互模式，即可开始运行安装脚本； 如果此前安装过服务器程序，可能需要先手动停止服务器程序：systemctl stop mybaseserver ，然后再次运行安装脚本； 如果安装脚本仍无法成功安装，则可尝试将服务器安装目录中程序文件全盘原样复制到指定的程序目录中，然后在终端窗口中运行 MybaseServer.Daemon.sh 脚本启动服务器程序，如果启动一切正常，服务器程序会自动进驻后台运行；操作命令类似如下：

  $ cd ~/MybaseServer $ cp -rp .MybaseServer/*.* /opt/MybaseServer/ $ /opt/MybaseServer/MybaseServer.Daemon.sh

  如仅需在终端窗口中运行或临时测试，暂不希望服务器程序进驻后台运行，可尝试以下命令：

  $ /opt/MybaseServer/MybaseServer.Terminal.sh

• macOS 系统

  首先打开下载得到的 .dmg 安装包文件, 然后双击打开其中服务器安装脚本程序，根据提示即可完成服务项安装。

  安装脚本默认将 Mybase Server 安装在应用程序目录 "/Applications/MybaseServer" 中，相应的 .nyf 数据库文件默认目录位于 "/Library/Application Support/MybaseServer/Repository"，日志文件默认目录位于："/Library/Application Support/MybaseServer/Logs"；

  安装脚本支持定制安装选项，可在安装过程中根据提示信息手动指定服务器程序监听 IP 地址、TCP 端口、以及存储数据库/日志文件的目录位置；

  如果已安装过旧版本，安装脚本会提示确认是否需要覆盖安装；另外在配置系统服务项时可能会提示输入 macOS 系统管理密码，以便授权安装脚本将 Mybase Server 配置为 Launchd 服务项并自动启动；

  服务器程序以默认选项安装成功后即可在当前服务器电脑系统中使用浏览器打开以下链接进入管理或编辑 Web 界面；

  • http://localhost:8082/welcome
  • http://localhost:8082/admin
  • http://localhost:8082/edit
  • http://localhost:8082/view

  其中 "8082" 为服务器程序默认监听端口，如果安装过程中已作修改/定制，则需替换为相应端口号；若通过网络远程访问服务器，将其中 "localhost" 替换为当前服务器系统外部网络 IP 地址或相应主机名；

  对于现有 .nyf 数据库，若需要迁移到服务器版中使用，可先将其复制或移动到服务器程序的数据库存储目录 "/Library/Application Support/MybaseServer/Repository" 中，然后使用 "/Applications/MybaseServer" 目录中已安装的服务管理工具，或通过终端命令行重新启动 mybaseserver 服务项，例如：

  % sudo Launchctl unload /Library/LaunchDaemons/com.wjjsoft.mybaseserver.plist % sudo Launchctl load /Library/LaunchDaemons/com.wjjsoft.mybaseserver.plist

  如果过程中出现异常情况，可在目录 "/Library/Application Support/MybaseServer/Logs" 中查看相关日志文件，或在终端窗口中使用 tail 命令，例如：

  % tail -n 150 -f "/Library/Application Support/MybaseServer/Logs/debug_20231001.log"

• Windows 系统

  解开下载得到的 .zip 压缩包，右键点击其中 .exe 安装程序，选择以管理员身份运行，然后根据提示即可完成服务器程序的安装； 如需将 Mybase Server 安装为系统服务项并自动启动，在安装最后一步务必勾选 "Register as NT service" 选项； 若未勾选该选项，Mybase Server 将会被安装为普通用应程序，在终端窗口中可手动启动服务器主程序；

  服务器程序以默认选项安装成功后即可在当前服务器电脑系统中使用浏览器打开以下链接进入管理或编辑 Web 界面；

  • http://localhost:8082/welcome
  • http://localhost:8082/admin
  • http://localhost:8082/edit
  • http://localhost:8082/view

  其中 "8082" 为服务器程序默认监听端口，如果安装过程中已作修改/定制，则需替换为相应端口号；若通过网络远程访问服务器，将其中 "localhost" 替换为当前服务器系统外部网络 IP 地址或相应主机名；

  如需控制管理该服务项，可使用 Windows 系统内置的 NT 服务管理控制器，或者使用鼠标右键单击开始菜单中的服务启动/停止菜单项（start/stop）并选择以管理员身份运行；

  对于现有 .nyf 数据库，若需要迁移到服务器版中使用，可先将其复制或移动到服务器程序的数据库存储目录 "C:\ProgramData\MybaseServer\Repository" 中，然后重新启动 Mybase Server 服务即可。

• 重新配置或调整服务器安装选项

  如需以自定义选项重新配置服务器程序，比如修改监听地址/端口、数据库/日志存储目录，在 Linux/macOS 系统中，可再次运行安装脚本，以自定义选项完成安装即可；

  在 Windows 系统中，安装程序本身不支持自定义端口和目录等选项，不过安装完成后，在安装目录中会提供一个 reconfigure.bat 配置脚本，以右键点击并选择以管理员身份运行，然后根据提示修改监听地址/端口、数据库/日志存储目录即可。

• 关于网络传输数据安全问题

  如果需要通过互联网远程访问数据库内容，可尝试另外安装配置 VPN 或者 Stunnel， 或者借助反向代理服务器程序（比如：Nginx， Apache 等） 提供的 Proxy-Pass 选项将 http 链接配置为 https 安全链接，以增强网络数据传输的安全性， 或者也可考虑配置使用 Traefik 实现该功能。

• 关于系统防火墙配置

  最新版本安装程序/脚本运行过程中会自动向系统防火墙中添加一项规则，以配置默认的 TCP/8082 或其它自定义端口接受网络连接请求并对外提供访问服务，通常情况下无需再为 Mybase Server 手动配置防火墙。

服务器中.nyf 数据库文件存储在哪个目录位置

服务器中 .nyf 数据库文件的存储目录位置可在服务器程序安装过程中自行修改定制，如果采用了缺省安装选项，则数据库文件存储在以下默认目录位置：

• Linux 系统: /var/opt/MybaseServer/Repository
• macOS 系统: /Library/Application Support/MybaseServer/Repository
• Windows 系统: C:\ProgramData\MybaseServer\Repository

服务器运行时 .log 日志文件存储在哪个目录位置

服务器运行事件日志文件的存储目录位置可在服务器程序安装过程中自行修改定制，如果采用了缺省安装选项，则服务器运行日志存储在以下默认目录位置：

• Linux 系统: /var/opt/MybaseServer/Logs
• macOS 系统: /Library/Application Support/MybaseServer/Logs
• Windows 系统: C:\ProgramData\MybaseServer\Logs

如何开启/停止服务器程序

针对 Linux 系统，在服务器程序正常安装完成后，可使用系统命令 systemctl 开启或停止服务，象这样：

$ sudo systemctl start mybaseserver $ sudo systemctl stop mybaseserver

针对 macOS 系统，在服务器程序正常安装完成后，可在 Finder 窗口中打开 /Applications/MybaseServer 文件夹，从中选择开启或停止服务，或者通过系统 Launchctl 命令开启或停止服务，象这样：

% sudo Launchctl load /Library/LaunchDaemons/com.wjjsoft.mybaseserver.plist % sudo Launchctl unload /Library/LaunchDaemons/com.wjjsoft.mybaseserver.plist

针对 Windows 系统，在服务器程序正常安装完成后，默认会自动启动服务器程序； 若需手动启/停操作，可选择使用开始菜单项，或者通过 Windows 服务控制管理器（SCM）界面来手动开启或停止服务。 注意：启/停服务器须以管理员身份操作，若通过开始菜单操作，务必以鼠标右键点击 Start 或 Stop 菜单，然后选择以管理员身份运行。

如何配置 http 反向代理并启用 https 安全链接

当前版本支持常用 web 服务器（比如：Nginx， Apache 等）提供的反向代理设置（Proxy-Pass）； 数据库服务程序通常不直接对外暴露 IP 地址和 TCP 端口，而是限于内网 (比如：localhost, 192.168.1.123) 中运行，然后通过反向代理服务器对外部网络提供服务； 如果反向代理服务器已正确安装 SSL 证书，则公网用户可通过 https 安全链接访问内网运行的数据库服务器，可防范数据在公网路由/传输过程中潜在的泄露风险。

例如：将 Mybase Server 安装在 Nginx 所在同一服务器系统中运行，并监听本机端口 localhost:8082，则可尝试如下 Proxy-Pass 配置：

server { listen 443 ssl; server_name xxx.com www.xxx.com; access_log /path/to/access.log; error_log /path/to/error.log; ssl_certificate /path/to/ssl_certificate.pem; ssl_certificate_key /path/to/ssl_certificate_key.pem; # ... other settings ... location /mybase/ { proxy_pass http://localhost:8082/; proxy_set_header Host $host; proxy_set_header Referer $http_referer; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }

以此配置重启 Nginx 服务后，内网中运行的 Mybase Server 即可通过安全链接 "https://www.xxx.com/mybase" 对外网用户提供服务； 其中 "xxx" 需替换为具体网站域名，"/path/to/ssl_certificate*" 需指向当前网站域名对应的 SSL 证书文件。 针对其它 web 服务器的 Proxy-Pass 设置概念大致类似，可具体查阅相应软件操作手册。

如果当前服务器域名尚未申请 SSL 证书，可尝试从 CA 证书颁发机构 申请一个免费证书； 而对于内部网站或临时使用，如果暂不打算从 CA 机构申请正式证书，也可考虑使用 OpenSSL 命令临时签发一个仅供内部使用的 自签名证书； 注：自签名证书有方便、自主、免续订等优点，但在安全性方面相对 CA 证书稍弱一些，在浏览器中首次打开网站页面时会提示证书颁发机构不受信任等问题，通常仅用于内部/临时/测试用途。

此外也可考虑使用其它反向代理工具软件，比如：Apache，Traefik 等。

如何内网穿透访问内网或家用电脑中安装的数据库服务器

如果将 Mybase Server 服务器程序安装在外部公网服务器电脑中运行，则可直接通过其公网 IP 地址或主机域名访问数据库； 如果安装在公司部门内网或家用电脑中运行并希望从外部公网访问数据库，可考虑借助 花生壳/Ngrok/Frp/autossh 等工具软件实现内网穿透，将内网中数据库服务器所在端口映射到外部公网指定服务器的指定端口，访问公网服务器对应端口即可自动转发到内网或家中服务器所在端口，从而实现从公网间接穿透访问到内网或家中数据库服务器； 参见：内网穿透教程。

如何注册为正式用户

经认真充分评估试用后，若该软件功能特性满足应用要求，且有意注册成为正式用户，请详见：针对中国境内用户的优惠政策。