开源 Wiki 软件 wiki.js

news2024/12/23 18:30:19

wiki.js简介

最强大、可扩展的开源Wiki 软件。使用 Wiki.js 美观直观的界面让编写文档成为一种乐趣！根据 AGPL-v3 许可证发布。

在这里插入图片描述

官方网站：https://js.wiki/

项目地址：https://github.com/requarks/wiki

主要特性：

随处安装：几乎可以在任何平台上运行，并且与 PostgreSQL、MySQL、MariaDB、MS SQL Server 或 SQLite 兼容！
管理区域：使用广泛且直观的管理区域管理 wiki 的各个方面。
性能表现：Wiki.js 在极快的 Node.js 引擎上运行，在构建时充分考虑了性能。
可定制：完全自定义 wiki 的外观，包括浅色和深色模式。
受保护：让您的 wiki 公开、完全私有或两者兼而有之。
可扩展：无论是在微型 Raspberry Pi 上还是在云中的高性能虚拟机上，Wiki.js 都会智能地利用可用资源。
简易安装：几分钟之内您就可以出发了！适用于所有平台的分步安装指南。

捆绑了您需要的一切，但并非所有团队都需要相同的功能集。这就是 Wiki.js 提供各种可以按需打开/关闭的模块的原因。

在这里插入图片描述

验证方式：

本地认证：具有自注册和密码恢复功能的内置身份验证。
社交认证：使用第三方身份验证服务，例如 Google、Facebook、Microsoft、GitHub、Discord、Slack 等。
企业认证：使用 LDAP、SAML、CAS、Auth0、Okta、Azure AD 等与您公司现有的身份验证集成。还包括通用 OAuth2 和 OpenID Connect 模块。
2FA：使用双因素身份验证为支持的身份验证模块添加额外的安全层。

编辑器支持：

Markdown：开发人员中最流行的文档格式。包括实时预览和工具栏/键盘快捷键快速访问。
Visual Builder：简单易用的所见即所得编辑器，适合非技术人员。无需编码或特殊语法知识。
Plain HTML：直接用 HTML 编写内容。非常适合从其他来源导入预格式化的 HTML 页面。

版本历史：

版本追踪：所有内容修改都会被跟踪。可以随时恢复到以前的状态或恢复已删除的页面。轻松跟踪谁更改了什么。
版本比较：直观地比较同一页面的两个版本，以准确了解发生了什么变化。
导出/分支：快速导出页面的特定版本或从旧版本创建新页面。

本地化支持：

有您的语言版本：Wiki.js 被翻译成 40 多种语言！如果您的语言尚不可用，请帮助我们使用易于使用的工具进行翻译。无需编码！
原生 RTL 支持：完全支持从右到左的语言。
多语言内容：让您的 wiki 支持多种语言。在同一页面的语言之间快速切换。

媒体资产：

资产管理：从资产管理器上传和管理您的媒体资产。轻松对文件夹中的资产进行分类并查看它们的使用位置。
图像编辑器：使用内置图像编辑器对图像执行各种转换。裁剪、调整大小和应用滤镜从未如此简单！

渲染功能：

代码高亮：插入具有全彩色语法突出显示和行编号的代码片段。
图表：轻松生成 UML、流程图、序列等图表。
数学表达式：使用 TeX 或 MathML 语法呈现复杂的数学表达式。
媒体播放器：包括 Youtube 视频、音频、asciinema 等媒体内容。

搜索功能：

数据库：Wiki.js 带有内置的搜索引擎。它需要零设置，是大多数用户的最佳选择。
云搜索：使用 Algolia、Azure 搜索等云搜索服务来增强您的 wiki 搜索功能。
Elasticsearch：使用您现有的 elasticsearch 安装来增强您的 wiki 搜索功能。
还有更多：使用 Manticore、Solr 或 Sphinx 等外部搜索引擎来增强您的 wiki 搜索功能。

存储功能：

Git：将您的内容同步或备份到流行的 Git 服务，例如 GitHub、GitLab、BitBucket、Azure DevOps 等。
企业云存储：将您的内容备份到 AWS S3、Azure Blob Storage、Google Cloud Storage、DigitalOcean Spaces 等云存储服务。
个人云存储：将您的内容备份到您的个人云存储服务，例如 Dropbox、Google Drive、MS OneDrive、Box 等。
本地/网络：使用基于 SSH 的安全复制将内容本地备份到磁盘/网络共享或网络上的远程服务器。

用户管理：

管理工具：从管理区域管理您的用户。快速创建新用户或编辑现有用户的各个方面。
分组：将用户分配到组中以控制他们可以执行的操作或访问的内容。无需浪费时间为每个用户分配权限！
权限：设置组权限以有效控制用户可以执行的操作或访问的内容。页面编辑、资产管理和访问管理区域各个部分的细化权限。
页面规则：使用精确路径、开始/结束和正则表达式过滤器为组设置高级和精确的页面规则。

主题功能：

自定义主题：创建您自己的主题以完全改变 wiki 的外观和感觉。
深色模式：选择 UI 的浅色和深色模式。
默认主题个性化：默认主题有许多颜色和显示选项。让它成为你自己的！
注入自定义CSS/JS：您可以直接从管理区域覆盖 CSS 或注入额外的 Javascript。

安装要求

安装前置要求如下：

Wiki.js 几乎可以在任何支持 Node.js 的系统上运行。这意味着它可以在Linux、macOS、Windows以及Docker/Kubernetes和Heroku等容器解决方案上运行。
Wiki.js 需要专用的子域/域*（例如wiki.example.com）*。您无法将 Wiki.js 映射到子文件夹。
为了获得最佳性能、功能和未来兼容性，强烈建议使用PostgreSQL。
需要 Node.js 运行时。
Wiki.js 不需要任何实际的 Web 服务器（例如 nginx 或 Apache）。但是，如果您需要高级网络/DNS 配置，您可能需要在 Wiki.js 前面放置一个反向代理。
已安装 docker 和 docker-compose。

docker 快速体验

使用sqlite数据库快速安装wiki。

docker run -d --name wiki \
  --restart unless-stopped \
  -p 80:3000 \
  -e DB_TYPE="sqlite" \
  ghcr.io/requarks/wiki:2

docker-compose安装

使用docker compose 以及 postgreSQL 数据库安装wiki。

创建一个名为 wiki 的新文件夹。在此文件夹中，创建一个名为 docker-compose.yaml 的新文件，并将以下内容粘贴到其中：

# docker-compose.yaml
version: "3"
services:

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"

volumes:
  db-data: