基于华为openEuler搭建Raneto知识库系统【华为根技术】

基于华为openEuler搭建Raneto知识库系统【华为根技术】

前言

随着企业对知识管理与文档协作需求的不断提升，构建一个高效、稳定且易于维护的知识库系统变得尤为重要。华为 openEuler 操作系统作为面向企业应用的高性能 Linux 发行版，为各类应用提供了坚实的基础平台。Raneto 作为一款基于 Node.js 的轻量级 Markdown 知识库系统，具备部署简单、使用灵活的特点。结合 openEuler 与 Raneto，不仅可以充分发挥华为根技术的性能优势，还能为企业打造一个安全可控、自主可信的知识管理平台。

一、相关服务介绍

1.1 openEuler系统介绍

• 简介

openEuler是华为发起并主导的一个开源操作系统项目，它基于Linux内核开发，致力于为企业级应用提供安全、稳定、可靠的操作环境。自2019年正式开源以来，openEuler迅速吸引了全球众多开发者和技术爱好者的关注，并逐渐形成了一个活跃的开源社区。该系统不仅支持多种处理器架构（如x86、ARM等），而且通过持续的技术创新，在性能优化、安全性增强以及容器化支持等方面展现了显著的优势。

• 主要特点

• 开源性：openEuler遵循开源协议，允许任何个人或组织自由获取、使用、修改及分发系统代码，这极大地促进了技术创新与共享。

• 高性能与稳定性：通过对Linux内核进行深度优化，openEuler能够提供出色的运行效率和稳定性，满足企业级应用场景的需求。

• 安全性：提供了包括安全启动、数据加密在内的多重安全保障措施，确保用户数据的安全性。

• 容器化支持：兼容Docker和Kubernetes等容器技术，便于开发者构建、部署和管理容器化应用。

• 丰富的生态系统：拥有庞大的开发者社区和丰富的软件库，为用户提供广泛的软件支持和服务。

1.2 Raneto介绍

• Raneto 简介

Raneto 是一个基于 Node.js 构建的开源 Markdown 知识库 Wiki 系统，允许用户通过浏览器创建和管理文档内容，适合用于构建文档中心、知识库或内部维基。

• 主要特点

1. 基于文件的内容管理：所有内容以 Markdown 文件形式存储，便于版本控制和本地编辑。

2. 支持文件名与内容搜索：提供全文搜索功能，方便用户快速查找所需信息。

3. 内置浏览器端 Markdown 编辑器：用户可直接在浏览器中创建和编辑 Markdown 文档。

4. 登录系统保护编辑权限：提供用户认证机制，确保只有授权用户可进行内容编辑。

5. 简洁轻量的设计：系统架构简单、易于部署和维护，资源占用低。

二、本次实践介绍

2.1 本次实践介绍

1.本次实践环境为个人测试环境，生产环境请谨慎；2.本次实践主要是在openEuler系统下搭建Raneto知识库。

2.2 本次环境规划

本次环境规划如下所示：

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

[root@openEuler ~]# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: disabled)
Active: active (running) since Sat 2025-03-29 20:58:28 CST; 1 day 20h ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 1382 (dockerd)
Tasks: 10
Memory: 115.9M ()
CGroup: /system.slice/docker.service
└─1382 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本，当前安装版本为 26.1.3。

[root@openEuler ~]# docker -v
Docker version 26.1.3, build b72abbb

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

[root@openEuler ~]# docker compose version
Docker Compose version v2.27.0

四、拉取Raneto镜像

执行以下命令，拉取Raneto容器镜像。

[root@openEuler ~]#docker pull raneto/raneto:0.17.6
0.17.6: Pulling from raneto/raneto
7264a8db6415: Pull complete
d68f2f1a5d31: Pull complete
e7e6b7606c1a: Pull complete
904e9a84b7a0: Pull complete
83d029c9aec8: Pull complete
77646b668941: Pull complete
3a837d7b585e: Pull complete
Digest: sha256:32b7ddfd6fa705bf820643d31de0f48112e1865d9f06ae29a74ad48671498ccb
Status: Downloaded newer image for raneto/raneto:0.17.6
docker.io/raneto/raneto:0.17.6

五、部署Raneto应用

5.1 创建挂载目录

执行以下命令，创建Coolmonitor部署目录/data/raneto 。

mkdir -p /data/raneto/{config,content} && cd /data/raneto

目录授权说明：由于当前为本地测试环境，可暂时授予完全权限；但请在生产环境中谨慎配置权限，确保安全性。

chmod -R 777 /data/raneto/

5.2 新建及编辑配置文件

在config/config.js配置文件中，编辑以下内容：

vim config/config.js

// Modules
import path from 'node:path';

// Which Theme to Use?
//
// Local Directory Example (for development or custom themes)
// const theme_dir = path.join(__dirname, 'themes');
// const theme_name = 'my-theme-directory';
//
// Themes from NPM
// use "dist" as the theme name for modules (for now)
const __dirname = import.meta.dirname;
const theme_dir = path.join(
__dirname,
'..',
'node_modules',
'@raneto/theme-default',
);
const theme_name = 'dist';

const config = {
// Your site title (format: page_title - site_title)
site_title: 'Raneto Docs',

// The base URL of your site (can use %base_url% in Markdown files)
// This should be the full path to your Raneto installation:
// example 1: https://raneto.mydomain.com
// example 2: https://www.mydomain.com/raneto
// Do not include a trailing "/"
// Leave this as an empty string to use the default
base_url: '',
nowrap: true,

// Path Prefix
// If you are running Raneto on a subpath of your domain, add it here
// Leave it blank if you are not sure
//
// Example: if you are running Raneto at http://www.mydomain.com/raneto
// then you would enter '/raneto' below
path_prefix: '',

// Used for the "Get in touch" page footer link
support_email: '',

// Footer Text / Copyright
copyright: `Copyright &copy; ${new Date().getFullYear()} - <a href="https://raneto.com" target="_blank">Powered by Raneto</a>`,

// Excerpt length (used in search)
excerpt_length: 400,

// The meta value by which to sort pages (value should be an integer)
// If this option is blank pages will be sorted alphabetically
page_sort_meta: 'sort',

// Should categories be sorted numerically (true) or alphabetically (false)
// If true category folders need to contain a "sort" file with an integer value
category_sort: true,

// Controls behavior of home page if meta ShowOnHome is not present. If set to true
// all categories or files that do not specify ShowOnHome meta property will be shown
show_on_home_default: true,

// Controls behavior of the menu if meta ShowOnMenu is not present. If set to true
// all categories or files that do not specify ShowOnMenu meta property will be shown
show_on_menu_default: true,

// Theme (see top of file)
theme_dir,
theme_name,

// Specify the path of your content folder where all your '.md' files are located
// Fix: Cannot be an absolute path
content_dir: path.join(__dirname, '..', 'content', 'pages'),

// Where is the public directory or document root?
public_dir: path.join(theme_dir, theme_name, 'public'),

// The base URL of your images folder,
// Relative to config.public_dir
// (can use %image_url% in Markdown files)
image_url: '/images',

// Add your analytics tracking code (including script tags)
analytics: '',

// Set to true to enable the web editor
allow_editing: true,

// Set to true to enable HTTP Basic Authentication
authentication: true,

// If editing is enabled, set this to true to only authenticate for editing, not for viewing
authentication_for_edit: true,

// If authentication is enabled, set this to true to enable authentication for reading too
authentication_for_read: false,

// Google OAuth
googleoauth: false,
google_group_restriction: {
enabled: false,
api_key: 'GOOGLE_API_KEY',
group_name: 'GOOGLE_GROUP_NAME',
},
oauth2: {
client_id: 'GOOGLE_CLIENT_ID',
client_secret: 'GOOGLE_CLIENT_SECRET',
callback: 'http://localhost:3000/auth/google/callback',
hostedDomain: 'google.com',
},
secret: 'someCoolSecretRightHere',

// ##### WARNING #####
// You MUST change the username and password for security
// Do NOT use "admin" as a username as it's easily guessed.
// You are encouraged to use tools to generate a password
// Preferably, use a local password manager
// If you absolutely must use an online tool, here are some suggestions
// https://bitwarden.com/password-generator/
// https://www.grc.com/passwords.htm
credentials: [
{
username: 'admin',
password: 'password',
},
{
username: 'admin2',
password: 'password',
},
],

locale: 'zh',

// Support search with extra languages
searchExtraLanguages: ['zh'],

// Sets the format for datetime's
datetime_format: 'Do MMM YYYY',

// Set to true to render suitable layout for RTL languages
rtl_layout: false,

// Edit Home Page title, description, etc.
home_meta: {
// title : 'Custom Home Title',
// description : 'Custom Home Description'
},

// variables: [
// {
// name: 'test_variable',
// content: 'test variable'
// },
// {
// name: 'test_variable_2',
// content: 'test variable 2'
// }
// ]

// Set to true to enable generation of table of contents
table_of_contents: false,

// Configure generation of table of contents (see markdown-toc's docs for details on available options)
table_of_contents_options: {
// append: 'Table of contents appendix',
// maxdepth: 6,
// firsth1: true,
},

menu_on_pages: true,
menu_on_page_collapsible: true,
};

// Exports
export default config;

在config.js文件中，我们可以修改三处地方：

• 站点名称

site_title: 'Raneto Docs',

null

• 登录用户名和密码

credentials: [
{
username: 'admin',
password: 'password',
},
{
username: 'admin2',
password: 'password',
},
],

null

• 支持中文语言

locale: 'zh',

// Support search with extra languages
searchExtraLanguages: ['zh'],

null

5.3 编辑docker-compose.yaml文件

本次实践部署使用docker compose方式，编辑docker-compose.yaml文件。部署文件中的宿主机映射端口可自定义修改，注意防止宿主机端口冲突。

vim docker-compose.yaml

version: "3.6"

services:
raneto:
image: raneto/raneto:latest
container_name: raneto
restart: always
ports:
- 7860:3000
volumes:
- /data/raneto/config:/opt/raneto/config
- /data/raneto/content:/opt/raneto/content

5.3 创建Raneto容器

执行以下命令，使用docker-compose.yaml文件创建Raneto容器。

docker compose up -d

null

5.4 检查Raneto容器状态

检查Raneto容器状态，确保Raneto容器正常启动。

[root@openEuler raneto]# docker compose ps
WARN[0000] /data/raneto/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
raneto raneto/raneto:latest "docker-entrypoint.s…" raneto 23 seconds ago Up 23 seconds 0.0.0.0:7860->3000/tcp, [::]:7860->3000/tcp

5.5 检查Raneto容器日志

检查Raneto容器日志，确保Raneto服务正常运行。

[root@openEuler raneto]# docker compose logs
WARN[0000] /data/raneto/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
raneto |
raneto | > raneto@0.17.8 start
raneto | > node server.js
raneto |
raneto | HTTP server listening on port 3000

5.6 安全设置

• 关闭selinux

setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

• 停止本地防火墙

systemctl stop firewalld
systemctl disable firewalld

六、访问Raneto服务

访问地址：http://服务器IP地址:7860，将IP替换为自己服务器的IP地址，进入到Raneto初始页。如果无法访问，则检查服务器防火墙是否设置，云服务器的安全组端口是否放行等。

null

我们在配置文件中定义的默认账号密码为admin/password，登录即可。

null

null

七、Raneto基本使用

7.1 上传文档

将 Markdown 格式文件上传至宿主机的 /data/raneto/content/pages 目录后，刷新页面即可立即在 Raneto 知识库中查看或编辑该内容。

root@jeven01:/data/raneto# mkdir -p content/pages
root@jeven01:/data/raneto# cd content/pages/
root@jeven01:/data/raneto/content/pages# ll
total 20
drwxr-xr-x 2 root root 4096 Jul 23 10:04 ./
drwxrwxrwx 3 root root 4096 Jul 23 10:03 ../
-rw-r--r-- 1 root root 8410 Jul 23 10:04 Linux系统之部署envlinks极简个人导航页.md
root@jeven01:/data/raneto/content/pages#

null

7.2 在线浏览文档内容

双击文章名称，即可在线浏览该文档内容，效果如下所示：

null

八、总结

通过在 openEuler 上部署 Raneto，我们实现了一个高效、稳定且具备自主可控能力的知识库系统。整个过程体现了 openEuler 对应用生态的良好支持，也展示了其作为企业级操作系统的强大适应性。借助华为根技术的底层优化与安全保障，系统运行更加流畅可靠。未来，结合更多华为技术生态组件，可进一步拓展该平台在企业内部的应用深度与广度。