【FDE知识库专栏】https://blog.csdn.net/freewebsys/category_13221845.html企业内部搭建 Wiki 常用的开源项目在 GitHub 上有非常多经典、成熟的选择。以下是按技术栈、特点以及开源协议分类的主流开源项目这个都是老项目了可以使用AI转换成go语言实现下。1. 现代化 / 颜值与性能兼顾Wiki.js开源协议AGPL-3.0技术栈Node.js Vue.js 数据库PostgreSQL, MySQL, SQLite 等特点目前 GitHub 上人气极高星标 28k的现代化 Wiki 系统。界面极其美观支持 Markdown / Visual 编辑器、多数据库、权限管理及与 GitHub/GitLab 自动双向同步。BookStack(现已迁移至 Codeberg但 GitHub 保留镜像)开源协议MIT技术栈PHP (Laravel) MySQL/MariaDB特点采用非常符合直觉的“书Book- 章节Chapter- 页面Page”层级结构对非技术人员友好支持所见即所得WYSIWYG和 Markdown 编辑器。https://demo.bookstackapp.com/books/bookstack-demo-site2. 轻量级 / 国产或轻量自研MM-Wiki开源协议MIT技术栈Go (Golang) MySQL特点国人开发、轻量级的企业知识分享与团队协同软件。单二进制文件部署极其简单支持独立空间、Markdown、LDAP 登录、附件上传及全文检索非常适合中小团队快速私有化部署。偏demo界面比较简陋。3. 经典老牌 / 高度可定制DokuWiki开源协议GPL-2.0技术栈PHP基于文本文件不需要数据库特点老牌轻量级 Wiki所有页面直接保存在服务器文本中备份迁移极其方便运行速度快适合对性能和简单性要求高的场景。XWiki开源协议LGPL-2.1技术栈Java特点企业级开源 Wiki 的老大哥功能极其强大且高度可编程类似开源版的 Confluence支持宏、复杂权限、工作流和海量插件适合大型企业深度定制。xwiki 的界面展示MediaWiki(维基百科同款引擎)开源协议GPL-2.0-or-later技术栈PHP 数据库 (MySQL/MariaDB/Postgres)特点全球最大规模的 Wiki 引擎稳定性与扩展性极强但学习曲线和页面语法Wikitext对企业普通日常文档编写可能稍显繁琐。4. 基于 Git / 文档即代码Docs-as-Code如果你们团队习惯用Markdown Git的工作流不需要复杂的在线协同数据库也可以考虑Docusaurus(Meta 开源)开源协议MITVuePress/VitePress(Vue 驱动)开源协议MITDocsify(轻量级动态渲染)开源协议MIT5开源代码wiki-go实现架构设计1. 目标与范围Wiki Go 将 BookStack 的核心 Wiki 能力迁移到 Go 技术栈目标包括单进程可运行GoFrame 同时提供 REST API 和 Vue SPA无需额外 Web 服务器。本地优先SQLite 文件 本地文件目录即可完成部署零外部依赖。保留 BookStack 心智模型书架 / 书籍 / 章节 / 页面、角色权限、受限实体、版本、回收站。可扩展分层清晰后续可替换数据库、增加 OIDC/SAML、导入器等。不在当前范围内MFA、OIDC/SAML、Webhook、ZIP 导入导出、画板、WYSIWYG 编辑器、主题系统、多语言完整翻译等。项目代码https://gitcode.com/any-to-go/wiki-go2. 总体架构┌──────────────────────────────────────────────────────────────┐ │ Browser (Vue 3 SPA) │ │ Vue Router · Pinia · Axios · marked/DOMPurify仅预览 │ └───────────────────────────┬──────────────────────────────────┘ │ HTTP (JSON / multipart) ┌───────────────────────────▼──────────────────────────────────┐ │ GoFrame HTTP Server │ │ CORS → Auth(JWT/Cookie) → Router → Controller │ │ │ │ │ Service 层 │ │ 权限校验 · 内容 CRUD · 搜索 · 版本 · 回收站 · 上传 │ │ │ │ │ GORM / glebarez SQLite │ │ │ │ │ data/wiki.db · data/uploads/images|files │ └──────────────────────────────────────────────────────────────┘生产模式下GET:/*由controller.Frontend处理请求优先命中go:embed内嵌的静态资源非/api且不带扩展名的路径回退到内嵌的index.html因此二进制运行时不依赖web/dist目录。3. 代码分层目录职责main.go调用cmd.Main.Run(gctx.GetInitCtx())internal/cmdgcmd命令定义转调app.Runinternal/app装配配置、数据库、服务与 HTTP Serverrouter.go注册全部路由internal/config从manifest/config/config.yaml读取配置并应用环境变量覆盖internal/dao打开 SQLite、AutoMigrate、写入权限/角色/设置/管理员/示例内容internal/modelGORM 模型与表名、实体类型常量internal/middleware认证上下文AuthContext、JWT/Cookie 提取、CORSinternal/service业务规则与权限判断按领域拆分为多个文件internal/controller解析请求参数、调用 service、统一响应不包含业务规则internal/response{code, message, data}响应封装与分页结构internal/apperr带 HTTP 状态码的业务错误internal/pkgMarkdown 渲染、JWT、slug 生成webVue 前端工程embed.go通过//go:embed all:dist将构建产物打入二进制依赖方向controller → service → model/daomiddleware被controller和service使用service不依赖controller。4. 请求生命周期GoFrame 命中路由执行分组中间件公共组CORS健康检查、系统状态、公共设置、登录受保护组CORS → AuthAuth依次从Authorization: Bearer或 HttpOnly Cookiewiki_token读取 JWT。校验 JWTHS256claimuid加载用户、角色与权限集合写入r.SetCtxVar(wiki.auth, *AuthContext)。Controller 通过h.auth(r)获取上下文解析参数r.Parse、GetRouter、表单/上传文件。Service 执行权限校验和业务逻辑返回领域对象或*apperr.Error。Controller 用response.Data/List输出统一 envelope。出错时response.Err映射业务错误到 HTTP 状态码400/401/403/404/409/500。认证细节登录返回 JWT同时写入HttpOnly、SameSiteLax的 Cookie便于img、下载链接等浏览器直接发起的请求鉴权。前端 Axios 额外通过Authorization头发送令牌。权限在每次请求时从数据库重新加载角色变更立即生效。admin系统角色短路所有权限检查。5. 权限模型5.1 角色与权限用户通过user_roles关联多个角色。角色通过role_permissions关联权限。权限命名entity-action-scope例如page-update-all、bookshelf-view-own。all表示对任意对象生效own仅对owned_by 当前用户的实体生效。内容实体权限书架、书籍、章节、页面 ×view/create/update/delete×all/own。系统权限users-manage、settings-manage、restrictions-manage-all/own、content-export等。功能权限附件、评论、图片的create/update/deleteall/own。5.2 可见性继承CanViewEntity不只检查实体自身还递归检查上级页面检查自身 → 章节若有→ 书籍若有章节检查自身 → 书籍书籍 / 书架检查自身因此书籍被设为受限时其下页面自动不可见。5.3 受限实体实体的restricted true时不再使用角色级all/own判断改为查询entity_permissions(entity_type, entity_id, role_id, action)拥有对应角色授权的用户才可执行该动作。/api/:type/:id/permissions用于读取/更新实体级授权仅restrictions-manage-all或实体拥有者 restrictions-manage-own可操作。5.4 创建子内容创建页面/章节时服务层要求能查看父实体拥有childType-create-all或拥有父实体且具备childType-create-own。6. 内容模型采用 BookStack 式单表多态设计entities表通过type区分bookshelf、book、chapter、page。书籍通过bookshelf_books与书架建立有序多对多关系。章节通过book_id归属书籍页面通过book_id/chapter_id归属书籍与可选章节。页面正文同时保存 Markdown、渲染后的 HTML 与纯文本搜索使用text展示使用html编辑使用markdown。软删除使用 GORMDeletedAt回收站查询使用Unscoped()。页面版本在page_revisions中保存快照超过配置上限时清理最旧版本。7. 数据一致性创建/更新实体时同步维护updated_by、updated_at、revision_count、标签与活动日志。删除书籍/章节/页面时级联软删除其子实体并记录deleted_by。恢复时校验父实体是否仍处于活跃状态针对页面。彻底删除时按类型清理版本、评论、附件与图片文件。实体级权限更新使用事务先清空该实体授权再按restricted重建。8. 搜索普通搜索name / description / markdown / text的LIKE匹配。标签搜索[namevalue]形式匹配tags表。结果统一经过CanViewEntity过滤避免越权泄露。摘要使用纯文本截断返回type/title/snippet/url。9. 上传与静态资源图片仅允许png/jpg/jpeg/gif/webp/bmp保存到data/uploads/images记录 MIME 与大小。附件保存到data/uploads/files/{pageID}支持外链附件。大小限制来自wiki.upload.maxSizeMb同时设置 GoFrame 请求体上限。图片通过GET /api/images/:id/file内联输出附件通过/download下载或 302 跳转外链。由于登录写入 Cookieimg src与下载链接可直接通过浏览器鉴权。前端静态资源web/dist经web/embed.go嵌入二进制由controller.Frontend通过fs.FS读取assets/*使用 immutable 缓存index.html使用no-cache。详见 前端内嵌。10. 错误与响应统一响应{code:0,message:ok,data:{}}失败时code为 HTTP 状态码message为面向用户的中文提示状态典型场景400参数缺失、类型不匹配、业务校验失败401未登录、令牌失效403权限不足404内容不存在、接口不存在409邮箱/角色名重复500未预期的数据库或系统错误11. 与 BookStack 的结构对应BookStackWiki GoLaravel Controller Routescontroller/app/router.goService/Reposservice/Eloquent Entity/Page/Book/Chapter单表model.Entityrestrictions表entity_permissionsrole_useruser_rolespermission_rolerole_permissionsBlade 视图Vue 页面与组件中间件authmiddleware.Authactivity日志activities表 logActivity上传目录data/uploads12. 扩展点与限制可扩展点在router.go增加路由与 controller 方法即可接入新功能。Service构造依赖*gorm.DB与*config.Config便于替换存储或注入测试库。权限判断集中在service/permission.go新增动作只需补充权限定义与判断。前端页面按路由懒加载新增模块只需增加路由与页面组件。当前限制所有内容接口要求登录app-public仅作为预留设置。无实时协作、无 Webhook、无 MFA/OIDC/SAML。搜索为 SQLiteLIKE数据量大时建议替换为 FTS5。回收站保留天数仅存设置自动清理任务尚未实现。导入器BookStack/ZIP尚未实现。
