技术分享 Public Site

RAGFlow项目配置与部署指南 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Fri, 23 Jan 2026 11:22:58 +0800

RAGFlow 项目配置与部署指南

作者：Manus AI 日期：2026年1月22日

摘要

RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在通过融合前沿的 RAG 技术与 Agent 能力，为大型语言模型提供卓越的上下文层 [1]。基于您提供的文件列表，该项目采用 Docker Compose 进行部署，以简化环境依赖（如 MySQL、MinIO、Redis 等）的管理。本指南将详细分析项目文件结构，并提供配置和启动 RAGFlow 服务的具体步骤。

1. 核心文件结构分析

理解项目文件结构是成功配置的第一步。以下表格总结了您提供的文件列表中，对配置和部署至关重要的文件和目录的功能：

文件/目录	功能描述	关键配置内容
`.env`	核心环境变量文件。包含 Docker 容器所需的重要环境变量，用于配置依赖服务的凭证、端口映射和镜像版本等。	`MYSQL_PASSWORD`, `MINIO_PASSWORD`, `SVR_HTTP_PORT`, `RAGFLOW_IMAGE`
`service_conf.yaml.template`	后端服务配置模板。定义 RAGFlow 核心服务的业务逻辑配置，如 LLM 供应商、日志级别等。容器启动时会基于此模板生成 `service_conf.yaml`。	LLM 配置（`factory`、`api_key`）、数据库连接信息（通过 `.env` 变量替换）
`docker-compose.yml`	默认部署编排文件。定义了 RAGFlow 服务及其所有依赖项（如 MySQL、MinIO、Redis、Elasticsearch/Infinity）的启动、网络和卷配置。	服务定义、端口映射、卷挂载
`docker-compose-CN-oc9.yml`	国内/OceanBase 优化版。可能针对国内用户优化了镜像源，或替换了默认的 MySQL 依赖为 OceanBase [2]。	依赖服务替换、镜像源配置
`nginx/` 目录	反向代理配置。包含 Nginx 配置文件，用于处理 HTTP/HTTPS 请求转发，通常默认监听 80 端口，并将请求转发给 RAGFlow 后端服务。	`nginx.conf`, `proxy.conf`, `ragflow.conf`
`entrypoint.sh`	容器启动入口脚本。负责在容器启动时执行初始化任务，例如根据 `.env` 文件替换模板变量，生成最终的 `service_conf.yaml` 文件，并启动 RAGFlow 服务。	环境初始化逻辑
`init.sql`	数据库初始化脚本。用于首次启动时创建 RAGFlow 所需的数据库和表结构。	SQL DDL/DML 语句

2. RAGFlow 配置步骤详解

RAGFlow 的配置主要集中在两个文件：.env 和 service_conf.yaml.template。

LFM2.5 1.2B Instruct在DockerOllama上的部署、训练与RAGFlow集成指南 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Fri, 23 Jan 2026 11:22:01 +0800

LFM2.5-1.2B-Instruct 模型在 Docker Ollama 上的部署、训练与 RAGFlow 集成指南

作者: Manus AI 日期: 2026年1月22日 工作语言: 简体中文

摘要

本文档旨在提供一个全面的技术指南，指导用户如何使用 Docker 和 Ollama 运行 LFM2.5-1.2B-Instruct 模型，如何利用 Unsloth 进行模型微调（训练），以及如何将该模型集成到 RAGFlow 平台中，以构建一个高效的本地检索增强生成（RAG）系统。LFM2.5-1.2B-Instruct 是 Liquid AI 推出的一款高性能、低内存占用的混合模型，非常适合在本地或边缘设备上部署 [1]。

一、使用 Docker Ollama 运行 LFM2.5-1.2B-Instruct

Ollama 是一个轻量级的框架，用于在本地运行大型语言模型（LLM）。通过 Docker 部署 Ollama 可以简化环境配置，并确保隔离性。

1. 部署 Ollama Docker 容器

首先，您需要确保系统已安装 Docker 和 NVIDIA Container Toolkit（如果需要 GPU 加速）。

使用以下命令运行 Ollama 容器，并将端口 11434 映射出来：

# 运行 Ollama 容器
# 如果需要 GPU 支持，请添加 --gpus all 参数
docker run -d \
    --name ollama \
    -p 11434:11434 \
    -v ollama:/root/.ollama \
    ollama/ollama

2. 拉取 LFM2.5-1.2B-Instruct 模型

LFM2.5-1.2B-Instruct 模型已被社区打包并上传到 Ollama 库中，通常以 lfm2.5-thinking:1.2b 或类似名称存在 [2]。

配置RagFlow 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Thu, 22 Jan 2026 14:07:36 +0800

RAGFlow 项目配置与部署指南

作者：Manus AI 日期：2026年1月22日

摘要

1. 核心文件结构分析

理解项目文件结构是成功配置的第一步。以下表格总结了您提供的文件列表中，对配置和部署至关重要的文件和目录的功能：

文件/目录	功能描述	关键配置内容
`.env`	核心环境变量文件。包含 Docker 容器所需的重要环境变量，用于配置依赖服务的凭证、端口映射和镜像版本等。	`MYSQL_PASSWORD`, `MINIO_PASSWORD`, `SVR_HTTP_PORT`, `RAGFLOW_IMAGE`
`service_conf.yaml.template`	后端服务配置模板。定义 RAGFlow 核心服务的业务逻辑配置，如 LLM 供应商、日志级别等。容器启动时会基于此模板生成 `service_conf.yaml`。	LLM 配置（`factory`、`api_key`）、数据库连接信息（通过 `.env` 变量替换）
`docker-compose.yml`	默认部署编排文件。定义了 RAGFlow 服务及其所有依赖项（如 MySQL、MinIO、Redis、Elasticsearch/Infinity）的启动、网络和卷配置。	服务定义、端口映射、卷挂载
`docker-compose-CN-oc9.yml`	国内/OceanBase 优化版。可能针对国内用户优化了镜像源，或替换了默认的 MySQL 依赖为 OceanBase [2]。	依赖服务替换、镜像源配置
`nginx/` 目录	反向代理配置。包含 Nginx 配置文件，用于处理 HTTP/HTTPS 请求转发，通常默认监听 80 端口，并将请求转发给 RAGFlow 后端服务。	`nginx.conf`, `proxy.conf`, `ragflow.conf`
`entrypoint.sh`	容器启动入口脚本。负责在容器启动时执行初始化任务，例如根据 `.env` 文件替换模板变量，生成最终的 `service_conf.yaml` 文件，并启动 RAGFlow 服务。	环境初始化逻辑
`init.sql`	数据库初始化脚本。用于首次启动时创建 RAGFlow 所需的数据库和表结构。	SQL DDL/DML 语句

2. RAGFlow 配置步骤详解

RAGFlow 的配置主要集中在两个文件：.env 和 service_conf.yaml.template。

在VMware虚拟机部署Gitlab😎

mr_yupengfei@foxmail.com (MrYuPengfei) — Wed, 21 Jan 2026 19:09:04 +0800

太棒了！恭喜您，这真是一次史诗级的故障排除，您展现了惊人的耐心和学习能力。最终找到根源——gitlab.rb 文件放错了位置——这是一个非常经典且容易被忽略的问题。

您能自己定位到这个问题，并用 cp 命令将其修正，这说明您已经完全掌握了 Docker 数据卷挂载的核心逻辑。为您喝彩！

总结：从启动失败到 HTTPS 成功，我们的排错之旅

好的，我们来全面复盘一下这次从零开始部署 GitLab 并最终成功启用 HTTPS 的全过程。这不仅是对我们工作的总结，更是一份极具价值的、可供未来参考的实践指南。

初始目标

在本地虚拟机（vm-noble）上，通过 Docker Compose 部署一个功能完整的 GitLab CE 实例，并为其配置公网可访问的 HTTPS。

第一阶段：Docker 权限与环境问题

问题 1：permission denied ... /var/run/docker.sock
- 现象：执行 docker 命令时报权限错误。
- 根源：当前用户 yupengfei 不在 docker 用户组中，无权访问 Docker 守护进程。
- 解决：通过 sudo usermod -aG docker yupengfei 将用户加入组，并重新登录使其生效。这是所有 Docker 用户都应该掌握的基础操作。
问题 2：The "GITLAB_HOME" variable is not set
- 现象：docker compose 警告环境变量未设置，导致镜像版本错误、数据卷挂载路径不正确。
- 根源：使用 sudo docker compose 时，当前用户的环境变量不会被传递给 root 环境。
- 解决：采用 docker-compose 的最佳实践——在项目根目录创建 .env 文件来定义环境变量 (GITLAB_HOME=...)。这使得配置与环境解耦，命令更简洁，行为更可预测。

第二阶段：`docker-compose.yml` 语法混淆

问题：configs 和 secrets 顶层配置块导致错误。
- 现象：docker compose up 无法解析 yml 文件。
- 根源：原始的 docker-compose.yml 混用了 Docker Compose 模式的语法和 Docker Swarm 模式的语法（configs, secrets）。
- 解决：将其完全重构为纯粹的 Docker Compose 语法。关键是将 configs 和 secrets 的功能，通过 volumes 挂载（将 gitlab.rb 和 root_password.txt 直接挂载到容器内指定路径）和 environment 注入（在环境块内用 Ruby 代码读取挂载的文件）来替代。

第三阶段：网络访问与 HTTPS 配置的曲折之路

这是最复杂、最曲折，但也最有价值的阶段。

让Hugo主题能够灵活地显示文章的封面图片 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 19 Jan 2026 17:20:08 +0800

需求背景

我们的核心需求是：让 Hugo 主题能够灵活地显示文章的封面图片，并且希望它能同时支持两种主流的图片引用方式：

页面包 (Page Bundle)：图片与 .md 文件存放在同一个目录下，路径只写文件名。
Static 目录：图片存放在全局的 static/images/ 目录下，路径写成根相对路径（如 /images/cat-hacker.png）。

问题分析

我们最初发现，主题模板默认只支持“页面包”模式。它使用了 Hugo 的 .Resources.GetMatch 函数来查找与文章捆绑的图片资源。这种方式功能强大，可以利用 Hugo 内置的图片处理能力（如裁剪、格式转换），但无法直接读取 static 目录下的文件。

解决方案：“优雅降级”的模板逻辑

为了实现“双模”支持，我们对主题的模板文件进行了修改，引入了一套“优雅降级”（Graceful Fallback）的逻辑。

核心思路如下：

优先采用最佳实践：模板首先会尝试将 Front Matter 中 images 参数提供的路径作为“页面资源”来查找。
如果成功：证明用户使用了“页面包”模式。模板会利用 Hugo 强大的图片处理 API（例如 .Fill）对图片进行自动裁剪、压缩和格式转换（如转为 WebP），以获得最佳的页面加载性能和显示效果。
如果失败：证明图片不是页面资源，模板则“降级”到第二方案。
执行回退方案：模板会判断该路径是否为一个指向 static 目录的根相对路径（即以 / 开头）。如果是，就直接使用该路径来渲染图片，但不进行任何图片处理，图片将以原始状态显示。

最终实现的代码

我们将模板中的相关部分替换为以下实现了“双模”逻辑的 Go Template 代码：

{{/* 获取 Front Matter 中定义的第一张图片路径 */}}
{{ $imagePath := index .Params.images 0 }}

{{/* 1. 优先尝试作为“页面资源”获取图片 */}}
{{ $imageResource := .Resources.GetMatch $imagePath }}

{{ if $imageResource }}
    {{/* --- 如果是页面资源，使用 Hugo 的图片处理功能 --- */}}
    {{ $image := $imageResource.Fill "600x300 Center webp" }}
    <img src="{{ $image.RelPermalink }}" ... >
{{ else }}
    {{/* --- 如果不是页面资源，则假定为 static 目录下的路径 --- */}}
    {{ if hasPrefix $imagePath "/" }}
        <img src="{{ $imagePath | absURL }}" ... >
    {{ end }}
{{ end }}

总结

通过这次修改，我们成功地让 Hugo 主题变得更加智能和健壮。它现在能够自动识别作者的图片引用方式，并尽可能地采用最优策略进行处理：

一次对WSL2“网络连接风暴”的深度诊断与修复实录 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 19 Jan 2026 16:55:15 +0800

前言

今天下午，我经历了一场堪称“完美风暴”的 WSL2 (Windows Subsystem for Linux) 故障。起初只是一个简单的 systemctl 命令报错，但随着排查的深入，问题如剥洋葱般层层展现，从上层应用一直牵扯到 Windows 的底层网络配置。最终，在经历了近乎“法医级别”的诊断后，我们成功让系统恢复了健康。

这不仅仅是一篇故障排除指南，更是一次对 WSL2 内部工作机制的深度探索。如果你也曾被 WSL2 的网络问题所困扰，那么这篇文章或许能为你提供一些思路和慰藉。

故障初现：`systemctl` 失效

一切始于一个常见的命令：

sudo systemctl enable --now ssh

得到的却是一个经典错误：

System has not been booted with systemd as init system (PID 1). Can't operate. Failed to connect to bus: Host is down

对于有经验的 WSL 用户来说，这通常意味着 systemd 没有启用。于是，我们按照官方推荐的方法，在 /etc/wsl.conf 中添加了配置：

[boot]
systemd=true

然后执行 wsl --shutdown 重启。然而，这只是噩梦的开始。

第一层迷雾：`apt` 网络中断

systemd 启用后，我们尝试运行 sudo apt update，却一头撞上了网络错误：

Temporary failure resolving 'archive.ubuntu.com'

Podman运行gitlab时的权限问题 😸

mr_yupengfei@foxmail.com (MrYuPengfei) — Sun, 18 Jan 2026 20:09:18 +0800

[gitlab] | Thank you for using GitLab Docker Image!
[gitlab] | Current version: gitlab-ce=18.8.0-ce.0
[gitlab] | 
[gitlab] | Configure GitLab for your system by editing /etc/gitlab/gitlab.rb file
[gitlab] | And restart this container to reload settings.
[gitlab] | To do it use docker exec:
[gitlab] | 
[gitlab] |   docker exec -it gitlab editor /etc/gitlab/gitlab.rb
[gitlab] |   docker restart gitlab
[gitlab] | 
[gitlab] | For a comprehensive list of configuration options please see the Omnibus GitLab readme
[gitlab] | https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md
[gitlab] | 
[gitlab] | If this container fails to start due to permission problems try to fix it by executing:
[gitlab] | 
[gitlab] |   docker exec -it gitlab update-permissions
[gitlab] |   docker restart gitlab
[gitlab] | 
[gitlab] | Cleaning stale PIDs & sockets
cat: /var/opt/gitlab/gitlab-rails/VERSION: No such file or directory
[gitlab] | Installing gitlab.rb config...
cp: cannot create regular file '/etc/gitlab/gitlab.rb': Permission denied
exit code: 1
yupengfei@LenovoY9000P:~/docker/gitlab$ ls -lah
yupengfei@LenovoY9000P:~/docker/gitlab$ ls -lah
total 1.7G
drwxr-xr-x  6 yupengfei yupengfei 4.0K Jan 18 20:05 .
drwxr-xr-x 12 yupengfei yupengfei 4.0K Jan 17 20:31 ..
-rw-r--r--  1 yupengfei yupengfei  993 Jan 18 18:52 compose.yml
drwxr-xr-x  3 yupengfei yupengfei 4.0K Jan 18 20:05 config
drwxr-xr-x  2 yupengfei yupengfei 4.0K Jan 18 20:05 data
-rw-r--r--  1 yupengfei yupengfei 1.2K Jan  6 17:56 docker-compose.local.yml
-rw-r--r--  1 yupengfei yupengfei  512 Jan 18 16:31 docker-compose.yml
-rw-------  1 yupengfei yupengfei 1.7G Jan 18 18:55 gitlab-ce.tar
-rw-r--r--  1 yupengfei yupengfei    2 Jan  5 16:06 install.sh
drwxr-xr-x  2 yupengfei yupengfei 4.0K Jan 18 20:05 logs
-rw-r--r--  1 yupengfei yupengfei   84 Jan  6 18:14 passwd.txt
-rw-r--r--  1 yupengfei yupengfei   14 Jan  5 20:51 rpc-ip.txt
-rw-r--r--  1 yupengfei yupengfei  304 Jan  5 19:47 run.260105.sh
-rw-r--r--  1 yupengfei yupengfei  296 Jan 18 17:34 run.sh.260118
drwxr-xr-x  2 yupengfei yupengfei 4.0K Jan  6 19:10 ssl

问题的关键：`security_opt` 与 `volumes` 的冲突

让我们看一下你 compose.yml 中的这两个配置项：

Podman使用本地在docker上下载的镜像 😎

mr_yupengfei@foxmail.com (MrYuPengfei) — Sun, 18 Jan 2026 19:20:20 +0800

这是一个非常常见的需求，尤其是在从 Docker 过渡到 Podman 或者两者混合使用的环境中。你完全可以利用已经在 Docker 中下载好的本地镜像，而无需为 Podman 重新下载一遍，这能节省大量的时间和带宽。

实现这个目标主要有两种方法：导出/导入 和 共享存储。

方法一：导出为 Tar 包，再导入 Podman (最通用、最推荐)

这个方法就像打包和解包，它不依赖于 Docker 和 Podman 的底层存储结构，因此兼容性最好，适用于任何系统。

步骤：

在 Docker 中保存镜像为 Tar 文件: 首先，找到你想要迁移的 Docker 镜像的名称和标签 (TAG)。你可以用 docker images 查看。
```
# 语法: docker save -o <输出文件名.tar> <镜像名:标签>
# 示例:
docker save -o gitlab-ce.tar docker.io/gitlab/gitlab-ce:18.8.0-ce.0
```
执行后，你会在当前目录下得到一个名为 gitlab-ce.tar 的文件。
在 Podman 中加载这个 Tar 文件: 现在，使用 podman load 命令将这个文件导入到 Podman 的本地存储中。
```
# 语法: podman load -i <文件名.tar>
# 示例:
podman load -i gitlab-ce.tar
```
验证镜像是否导入成功: 使用 podman images 命令检查镜像是否已经存在于 Podman 的列表中。

如何在hugo中设置文章头 😎

mr_yupengfei@foxmail.com (MrYuPengfei) — Sun, 18 Jan 2026 19:09:04 +0800

这是一个非常核心的 Hugo 功能。hugo new content 命令生成的文章内容的默认模板头（即 front matter）是在 archetypes（原型）目录中设置的。

核心概念：Archetypes (原型)

你可以把 Archetype 文件想象成一个“蓝图”或“模板”。当你使用 hugo new content <SECTION>/<FILENAME>.md 命令创建一个新的内容文件时，Hugo 会执行以下逻辑：

它会去你的项目根目录下的 archetypes 文件夹里寻找一个与 <SECTION> 同名的 .md 文件。
如果找到了（例如 archetypes/posts.md），Hugo 就会使用这个文件的内容作为新创建的 content/posts/new-post.md 文件的初始内容。
如果没有找到特定 section 的原型文件，Hugo 会使用 archetypes/default.md 这个文件。
如果连 archetypes/default.md 都没有，Hugo 会生成一个只包含最基本 front matter 的文件（通常只有 title, date, 和 draft: true）。

如何设置和修改默认模板

1. 找到或创建 `default.md`

这是控制所有未指定类型内容（或者说，没有自己专属原型的内容）的全局默认模板。

位置： 你的Hugo项目根目录/archetypes/default.md
如果文件不存在： 你可以自己创建一个。

默认内容通常是这样的：

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

解释一下这些变量：

Matrix 聊天服务器 🎠

mr_yupengfei@foxmail.com (MrYuPengfei) — Fri, 16 Jan 2026 17:30:34 +0800

部署架构图

      公网用户 (Internet)
            |
            | (访问 matrix.your-domain.com 和 element.your-domain.com)
            v
+---------------------------+
|   云服务器 (有公网 IP)    |
|---------------------------|
|   - Nginx (处理 HTTPS)    |
|   - frps (接收 frpc 连接) |
+---------------------------+
            ^
            | (frp 隧道)
            |
+---------------------------+
|  内网服务器 (无公网 IP)   |
|---------------------------|
|   - frpc (连接到 frps)    |
|   - Matrix (Synapse)      |
|   - Element (Web)         |
|   - PostgreSQL 数据库     |
+---------------------------+

摘要

本文旨在为技术爱好者提供一份详尽的指南，介绍如何利用 Docker 容器化技术和 frp 内网穿透工具，在没有公网 IP 的家庭或办公网络环境中，成功部署并运维一套功能完整的 Matrix 去中心化即时通讯服务。我们将深入探讨其实现原理、技术方案选型，并提供从零开始的、可复现的部署步骤。

互联网信息服务单位网络安全责任告知书 🎠

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 12 Jan 2026 20:42:42 +0800

为了保护网络信息安全，保障公民、法人和其他组织的合法权益，维护国家安全和社会公共利益，根据《中华人民共和国计算机系统安全保护条例》《计算机信息网络国际联网安全保护管理办法》等相关法律法规规定，现就你单位应依法履行的网络安全责任告知书如下：

一、具备法律法规所要求的相应资质；

互联网信息服务提供者应为独立承担法律责任的主体，从事互联网信息服务依据法律、行政法规以及国务院有关规定，需经有关部门许可的应取得相应许可资质

二、依法接受公安机关监督、检查、指导；

三、协助公安机关依法查处涉网违法犯罪活动；

四、根据《中华人民共和国计算机信息系统安全保护条例》《计算机信息技术网络国际互联网安全保护管理办法》《互联网安全保护技术措施规定》《互联网交互式服务安全保护要求》《互联网服务安全评估基本程序及要求》等相关法律法规以及安全管理标准规范，履行违法信息过滤、公共信息巡查用户资质查验、日志信息留存和应急快速处置等安全保护义务，落实安全管理责任和相关安全保护技术措施；

五、在网站首页显著位置张贴公安机关核发的备案图标；

六、当联网备案信息发生变更时，请您于变更后30日内登录本平台提交变更信息，若未按规定要求、时限办理变更手续，公安机关将依法通知接入商暂停网站接入；

七、当网站不再开办时，请您于5个工作日内登录本平台，向属地公安机关网安部门提出撤销申请。

-– 来源： https://beian.mps.gov.cn

Hyperlink是什么？

mr_yupengfei@foxmail.com (MrYuPengfei) — Sat, 10 Jan 2026 10:54:50 +0800

Hyperlink是一款英伟达主导开发的Windows平台下的AI部署软件，可以在不联网的情况下，使用英伟达GPU，构建自己的知识库。

On-Device AI Super Assistant

https://hyperlink.nexa.ai/

关于本站

mr_yupengfei@foxmail.com (MrYuPengfei) — Thu, 08 Jan 2026 20:49:37 +0800

本网站是使用Hugo框架生成的静态网站。部署于Nginx服务器以及github.io托管平台，用于分享信息技术。

Virtual Partners 🎠

mr_yupengfei@foxmail.com (MrYuPengfei) — Sat, 01 Mar 2025 20:49:37 +0800

基于Qt的AI桌面伙伴

基于Qt6的桌面伴侣，可以在Windows10/11和支持X11的Linux发行版（例如Mint/Ubuntu）上使用。

(音乐和图片素材仅供程序调试使用，不用于任何盈利用途)

三种版本

版本一：基于PyQt5和PyGame的版本

（提供msi安装包，无内存溢出的风险）：

https://gitee.com/yupengfei1074064684/yuanshen-desktoppet

https://github.com/MrYuPengfei/yuanshen-desktoppet

WindowsNT原神桌面宠物安装向导。附上百度网链接：

通过百度网盘分享的文件：原神桌面宠物V1.7安装向导.exe 链接：https://pan.baidu.com/s/1ZLYbpay6syzQD8Mn4rHM9A?pwd=dey6

版本二：基于版本一和Ollama人工智能模型的版本（由于AI服务器到期，目前暂停AI服务）

（建议在Windows11，内存在16GB以上，的电脑上使用，无安装包）：

https://gitee.com/yupengfei1074064684/LlamaVirtualPartners

版本三（推荐)：基于Qt6的跨平台版本：

（支持百度千帆大模型，可以在Windows11和Linux Mint Cinnamon Edition 上使用）：

https://gitee.com/yupengfei1074064684/virtual-partners4-pc

https://github.com/MrYuPengfei/VirtualPartners

Windows11

提供支持windows11的安装向导：

通过网盘分享的文件：原神主题桌面伙伴V2.0.1安装向导.exe 链接: https://pan.baidu.com/s/18anvnHh71icC85X15fQQDQ?pwd=vmu3 提取码: vmu3 –来自百度网盘超级会员v7的分享

Linux Mint Cinnamon Edition

尚在更新中，暂不提供deb包，目前可现在QtCreater中调试。

自定义

可以手动添加你喜欢的动漫角色，将png图片和mp3资源导入安装目录即可。本项目默认提供原神主题，图片和音频来自互联网。

使用自定义域名访问 GitLab 私有仓库

mr_yupengfei@foxmail.com (MrYuPengfei) — Sat, 01 Mar 2025 20:49:37 +0800

🎯 关键

一部分gitlab的配置可以通过在web端通过登录root用户进行admin修改。部分需要修改服务器下关于gitlab的配置文件。

Gitlab主要配置文件

一、GitLab 最核心的配置文件（99% 的修改都在这）

1. `/etc/gitlab/gitlab.rb`（主配置文件，必记！）

作用：GitLab 所有全局配置的「入口文件」，包括外部访问 URL、端口、存储路径、邮件、SSL、LDAP、内置组件（Nginx/PostgreSQL/Redis）等，是你唯一需要手动修改的配置文件。
特点：默认全是注释（# 开头），只需要取消注释并修改对应参数，无需手写配置；修改后不会立即生效，需要执行命令生成实际配置。
新手常用配置示例：

# 1. 设置GitLab外部访问地址（最基础配置）
external_url 'https://gitlab.yourdomain.com'

# 2. 修改GitLab内置Nginx的端口（默认80/443）
nginx['listen_port'] = 8080
nginx['listen_https'] = false  # 若用HTTP访问

# 3. 设置数据存储路径（默认/var/opt/gitlab）
git_data_dirs({ "default" => { "path" => "/data/gitlab/git-data" } })

# 4. 邮件配置（发送通知）
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_port'] = 465

2. `/var/opt/gitlab/gitlab-rails/etc/gitlab.yml`（实际生效的应用配置）

作用：由 /etc/gitlab/gitlab.rb 生成的「最终生效配置文件」，包含 GitLab Rails 应用的所有细节配置。
注意：不要手动修改！修改后会被 gitlab-ctl reconfigure 覆盖，所有改动都要在 gitlab.rb 中完成。

二、GitLab 各组件的专属配置文件（由 gitlab.rb 生成）

GitLab 是「一站式包」，内置 Nginx/PostgreSQL/Redis 等组件，它们的配置文件由 gitlab.rb 生成，路径如下：

组件	配置文件路径	作用
内置 Nginx	`/var/opt/gitlab/nginx/conf/gitlab-http.conf`	GitLab 访问的 Nginx 配置
PostgreSQL	`/var/opt/gitlab/postgresql/data/postgresql.conf`	数据库配置
Redis	`/var/opt/gitlab/redis/redis.conf`	缓存服务配置
GitLab Shell	`/var/opt/gitlab/gitlab-shell/config.yml`	Git 命令行/SSH 配置
Sidekiq	`/var/opt/gitlab/gitlab-rails/etc/sidekiq.yml`	异步任务队列配置

三、其他辅助配置文件

1. 日志相关

日志存储路径：/var/log/gitlab/（各组件日志分目录存放，如 gitlab-rails/、nginx/）
日志配置：在 gitlab.rb 中修改（如日志级别、保留天数）：

logging['log_level'] = 'info'  # 日志级别：debug/info/warn/error
logging['keep_rails_logs_for_days'] = 7  # 日志保留7天

2. 备份/权限配置

备份配置：在 gitlab.rb 中设置备份路径、保留时间：

gitlab_rails['backup_path'] = "/data/gitlab/backups"
gitlab_rails['backup_keep_time'] = 604800  # 备份保留7天（秒）

权限配置：/etc/gitlab/permissions.json（定义各目录/文件的默认权限，一般无需修改）。

四、修改配置后的生效步骤（核心！新手必看）

修改 /etc/gitlab/gitlab.rb 后，必须执行以下命令让配置生效：

在WSL2构建 GitLab 私有仓库

mr_yupengfei@foxmail.com (MrYuPengfei) — Sat, 01 Mar 2025 20:49:37 +0800

如果WSL2有多个ubuntu，如ubuntu22和ubunut24，只要有一个主机占用了gitlab所需要的端口，就不能正常使用gitlab。
尽量使用官方教程使用apt包管理工具进行安装。
使用docker部署gitlab在WSL2上很麻烦。
部署后，如果需要让别人访问部署再WSL2中的Gitlab，最好再配置一个frp服务器和一个frp客户端，使得其他人可以通过frp服务，通过公网IP进行访问WSL2（个人笔记本或台式机）上的Gitlab服务
关于frp的部署网上有很多教程，对于AI Agent 给出的部署方案，需要一定的鉴别能力，如果行不通果断看frp的部署教程视频，不要浪费太多时间。

Hugo v0.119.0

mr_yupengfei@foxmail.com (MrYuPengfei) — Sun, 24 Sep 2023 00:00:00 +0800

This version is built with Go 1.21.1 which contains some relevant security fixes for the html/template package, see Issue 62196 and Issue 62197. This is the main reason Hugo 0.119.0 is released sooner rather than later. But this release also comes with a dependency refresh and some useful image processing improvements:

A new general-purpose Process method and filter. A new Opacity filter.

Release Notes on GitHub.

Bootstrap 5.3.0

mr_yupengfei@foxmail.com (MrYuPengfei) — Tue, 30 May 2023 00:00:00 +0800

It’s official, the final stable release of v5.3.0 has landed! It’s been a monumental effort to revamp our codebase for CSS variables and color modes, one that will see continued changes leading up to an eventual Bootstrap 6. And we’re so excited to finally ship it!

On top of all the work that’s gone into this release, a lot has happened behind the scenes since we shipped our pre-releases. Keep reading to learn everything that’s new in v5.3.0.

Hugo v0.100.2

mr_yupengfei@foxmail.com (MrYuPengfei) — Wed, 08 Jun 2022 00:00:00 +0800

This release is mostly motivated by the fix for the panic experienced by people having blackfriday configured as defaultMarkdownHandler (#9968). The Blackfriday support was removed in Hugo v0.100.0 after being deprecated with a warning for a long time.

v0.100.1 fix panic with markdownify/RenderString with shortcode on Page with no content file.

$page.RenderString (see #6703) finally supports shortcodes, and shortcode improvements is the main theme in Hugo 0.100.0.

Release Notes on GitHub.

Hugo Bootstrap Theme alpha

mr_yupengfei@foxmail.com (MrYuPengfei) — Sun, 22 May 2022 13:35:02 +0100

Hugo theme for a secure, blazing fast and SEO-ready static website, using Bootstrap 5.

Open-source MIT Licensed Hugo Theme, using Bootstrap 5.

🛡️ Security aware

Get A+ scores on Mozilla Observatory out of the box. Easily change the default Security Headers to suit your needs.
⚡ Fast by default

Get 100 scores on Google Lighthouse by default. Hugo Bootstrap Theme removes unused css, prefetches links, and lazy loads images.
📈 SEO-ready

Hugo v0.99.1

mr_yupengfei@foxmail.com (MrYuPengfei) — Wed, 18 May 2022 00:00:00 +0800

Fix server regression for multihost sites (multiple languages with different baseURLs).

Release Notes on GitHub.

Bootstrap 5.2.0 beta

mr_yupengfei@foxmail.com (MrYuPengfei) — Fri, 13 May 2022 13:00:44 +0100

It’s the biggest release since v5 itself—Bootstrap v5.2.0-beta1 is here! This release features redesigned docs, CSS variables for all our components, responsive offcanvas, new helpers and utilities, refined buttons and inputs, and lots of improvements under the hood.

Given the size of the update and time since our last release, we’re doing something different and shipping it as a beta first. Keep reading for details.

Bootstrap Carousel 🎠

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Bootstrap Carousel

A slideshow component for cycling through elements—images or slides of text — like a carousel.

See Carousel documentation.

Bootstrap Components ✨

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Bootstrap Components

Bootstrap is bundled with tens of components that can be reused to provide a good user experience and user interactions in a web page.

Accordion

This is the first item's accordion body. It is shown by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the .accordion-body, though the transition does limit overflow.

This is the second item's accordion body. It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the .accordion-body, though the transition does limit overflow.

This is the third item's accordion body. It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the .accordion-body, though the transition does limit overflow.

See Accordion documentation.

Code of Conduct

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

…

Code of Conduct

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Contributor Covenant Code of Conduct

Contact

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

WeChat

mr_yupengfei

Tencent QQ

1074064684

Email

ORCID

https://orcid.org/0009-0009-1668-4543

Simple Page

Github

https://github.com/mryupengfei

Gitee

https://gitee.com/yupengfei1074064684

Markdown Cheat Sheet Ⓜ️⬇️

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Markdown Cheat Sheet

Hugo has excellent Markdown support out of the box. By default, Hugo uses the Goldmark Markdown processor which is fully CommonMark-compliant. See the configuration instructions to learn more about the extensions you can configure.

Overview

You can refer to the table below for an overview of basic markdown syntax:

TASK	MARKDOWN SYNTAX
Heading 1	`#`
Heading 2	`##`
Heading 3	`###`
Italics	`italics`
Bold	`Bold`
Strike	`~~strike~~`
Blockquote	`>`
Links	`[link name](https://link.com)`
Images	`![Image name](image.png)`
Unordered list	`* List item`
Ordered list	`1. List item`
Inline Code	`insert code here`

Headings

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

Lists

* Unordered item
* Unordered item
* Unordered item

1. Ordered item
2. Ordered item
3. Ordered item

- [ ] Task item
- [x] Checked Task item
- [ ] Task item

Unordered item
Unordered item
Unordered item

Ordered item
Ordered item
Ordered item

Task item
Checked Task item
Task item

Format

**Bold**

*Italic*

<u>Underline</u>

<sup>Superscript</sup>

<sub>Subscript</sub>

<mark>Highlight</mark>

`Inline code`

~~Strikethrough~~

[Hyperlink](http://example.com)

![Image](placeholder-50-09f-fff.png)
{ .img-fluid }

Bold

Privacy Policy

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Privacy Policy

TL;DR: We do not use cookies and we do not collect any personal data.

Website visitors

No personal information is collected.
No information is stored in the browser.
No information is shared with, sent to or sold to third-parties.
No information is shared with advertising companies.
No information is mined and harvested for personal and behavioral trends.
No information is monetized.

Information we collect and what we use it for

The server hosting this site can collect the following information:

Security Best Practices 🔒

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

Security Best Practices

Improve code health of your web page following these best practices.

Use HTTPS

All websites should be protected with HTTPS, even ones that don’t handle sensitive data. HTTPS prevents intruders from tampering with or passively listening in on the communications between your site and your users.

External Links

When you link to a page on another site using the target="_blank" attribute, you can expose your site to performance and security issues:

关于本站

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

使用了Hugo Bootstrap Theme Hugo主题 ❤️ 。

通讯

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

微信

mr_yupengfei

QQ

1074064684

电子邮箱

ORCID

https://orcid.org/0009-0009-1668-4543

Simple Page

Github

https://github.com/mryupengfei

Gitee

https://gitee.com/yupengfei1074064684

隐私政策

mr_yupengfei@foxmail.com (MrYuPengfei) — Mon, 01 Jan 0001 00:00:00 +0000

隐私政策

本网站不使用cookies，也不收集任何个人数据。

网站访问者

不收集任何个人信息。
在浏览器中不存储任何信息。
不与第三方共享、发送或出售任何信息。
不与广告公司共享任何信息。
不进行个人和行为趋势的数据挖掘和收集。
不进行信息货币化。

我们收集的信息及其用途

托管此网站的服务器可以收集以下信息：

页面URL
HTTP引荐来源
浏览器
操作系统
设备类型
IP地址

所有日志在每次发布时都会被删除。

技术分享 Public Site

RAGFlow项目配置与部署指南 😸

RAGFlow 项目配置与部署指南

摘要

1. 核心文件结构分析

2. RAGFlow 配置步骤详解

LFM2.5 1.2B Instruct在DockerOllama上的部署、训练与RAGFlow集成指南 😸

LFM2.5-1.2B-Instruct 模型在 Docker Ollama 上的部署、训练与 RAGFlow 集成指南

摘要

一、使用 Docker Ollama 运行 LFM2.5-1.2B-Instruct

1. 部署 Ollama Docker 容器

2. 拉取 LFM2.5-1.2B-Instruct 模型

配置RagFlow 😸

RAGFlow 项目配置与部署指南

摘要

1. 核心文件结构分析

2. RAGFlow 配置步骤详解

在VMware虚拟机部署Gitlab😎

总结：从启动失败到 HTTPS 成功，我们的排错之旅

初始目标

第一阶段：Docker 权限与环境问题

第二阶段：docker-compose.yml 语法混淆

第三阶段：网络访问与 HTTPS 配置的曲折之路

让Hugo主题能够灵活地显示文章的封面图片 😸

需求背景

问题分析

解决方案：“优雅降级”的模板逻辑

最终实现的代码

总结

一次对WSL2“网络连接风暴”的深度诊断与修复实录 😸

前言

故障初现：systemctl 失效

第一层迷雾：apt 网络中断

Podman运行gitlab时的权限问题 😸

问题的关键：security_opt 与 volumes 的冲突

Podman使用本地在docker上下载的镜像 😎

方法一：导出为 Tar 包，再导入 Podman (最通用、最推荐)

如何在hugo中设置文章头 😎

核心概念：Archetypes (原型)

如何设置和修改默认模板

1. 找到或创建 default.md

Matrix 聊天服务器 🎠

部署架构图

摘要

互联网信息服务单位网络安全责任告知书 🎠

Hyperlink是什么？

On-Device AI Super Assistant

关于本站

Virtual Partners 🎠

基于Qt的AI桌面伙伴

三种版本

版本一：基于PyQt5和PyGame的版本

版本二：基于版本一和Ollama人工智能模型的版本（由于AI服务器到期，目前暂停AI服务）

版本三（推荐)：基于Qt6的跨平台版本：

Windows11

Linux Mint Cinnamon Edition

自定义

使用自定义域名访问 GitLab 私有仓库

🎯 关键

Gitlab主要配置文件

一、GitLab 最核心的配置文件（99% 的修改都在这）

1. /etc/gitlab/gitlab.rb（主配置文件，必记！）

2. /var/opt/gitlab/gitlab-rails/etc/gitlab.yml（实际生效的应用配置）

二、GitLab 各组件的专属配置文件（由 gitlab.rb 生成）

三、其他辅助配置文件

1. 日志相关

2. 备份/权限配置

四、修改配置后的生效步骤（核心！新手必看）

在WSL2构建 GitLab 私有仓库

Hugo v0.119.0

Bootstrap 5.3.0

Hugo v0.100.2

Hugo Bootstrap Theme alpha

Hugo v0.99.1

Bootstrap 5.2.0 beta

Bootstrap Carousel 🎠

Bootstrap Carousel

Bootstrap Components ✨

Bootstrap Components

Accordion

第二阶段：`docker-compose.yml` 语法混淆

故障初现：`systemctl` 失效

第一层迷雾：`apt` 网络中断

问题的关键：`security_opt` 与 `volumes` 的冲突

1. 找到或创建 `default.md`

1. `/etc/gitlab/gitlab.rb`（主配置文件，必记！）

2. `/var/opt/gitlab/gitlab-rails/etc/gitlab.yml`（实际生效的应用配置）