Wiki.js 安装与配置指南

Wiki.js 安装与配置指南

wiki- Wiki.js | A modern and powerful wiki app built on Node.js wiki- 项目地址: https://gitcode.com/gh_mirrors/wiki78/wiki-

1. 项目基础介绍

Wiki.js 是一个现代且功能强大的基于 Node.js 构建的维基应用。它允许用户创建、编辑和管理内容,非常适合作为知识库或文档管理系统。Wiki.js 使用现代的前端技术,提供了直观的用户界面和丰富的功能。

主要编程语言

  • 前端: Vue.js
  • 后端: Node.js
  • 样式: SCSS

2. 项目使用的关键技术和框架

  • 前端框架: Vue.js,用于构建用户界面。
  • 后端框架: Express.js,Node.js 的一个快速、无开箱即用的 Web 应用框架。
  • 数据库: 支持多种数据库,如 MongoDB, MySQL, PostgreSQL, SQLite 等。
  • Markdown 渲染: 使用 Markdown-it 进行 Markdown 渲染。
  • 身份验证: 支持多种身份验证机制,包括 OAuth, LDAP, SAML 等。

3. 项目安装和配置的准备工作

在开始安装 Wiki.js 之前,请确保您的系统已经安装以下依赖:

  • Node.js: 建议14+版本。
  • npm: Node.js 的包管理器。
  • 数据库: MongoDB, MySQL, PostgreSQL, 或 SQLite。
  • Git: 用于克隆项目代码。

详细的安装步骤

  1. 克隆项目代码

    打开命令行界面,执行以下命令以克隆项目代码:

    git clone https://github.com/requarks/wiki.git
    cd wiki
    
  2. 安装依赖

    使用 npm 安装项目所需的依赖:

    npm install
    
  3. 配置数据库

    根据您选择的数据库类型,创建一个新的数据库实例,并记下相关的连接信息。

  4. 配置项目

    在项目目录中,创建一个新的 config.yml 文件,并填入您的数据库连接信息和其他配置:

    port: 3000
    database:
      type: mongo
      host: localhost
      port: 27017
      name: wikijs
      user: ''
      pass: ''
    

    根据您的数据库类型,相应地更改 type, host, port, name, userpass 字段。

  5. 启动项目

    使用 npm 启动 Wiki.js:

    npm start
    

    如果一切配置正确,Wiki.js 将在 http://localhost:3000 上运行。

  6. 初次访问

    在浏览器中访问 http://localhost:3000,您应该能够看到 Wiki.js 的安装向导。按照向导的提示完成剩余的配置步骤。

以上就是 Wiki.js 的基础安装和配置过程。按照上述步骤操作,您应该能够成功搭建一个功能完整的维基应用。

wiki- Wiki.js | A modern and powerful wiki app built on Node.js wiki- 项目地址: https://gitcode.com/gh_mirrors/wiki78/wiki-

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

<think>好的,用户想在CentOS 9上安装Wiki.js。我之前处理过类似的问题,记得CentOS 7的安装步骤,但CentOS 9可能有些不同。首先,需要确认系统依赖,比如Node.js、数据库(比如PostgreSQL或MySQL)、Web服务器(比如Nginx)是否安装。 用户提供的引用中提到需要安装Node.js,版本v16.18.1。但CentOS 9的软件源可能提供更新的版本,需要检查兼容性。或者按照Wiki.js官方文档推荐的Node.js版本。另外,用户之前的步骤里用了Nginx,但CentOS 9可能默认使用其他软件,需要确认配置是否正确。 然后,下载Wiki.js安装包。引用中提到了从GitHub下载tar.gz文件,解压到指定目录,并配置config.yml文件。CentOS 9的目录结构可能和CentOS 7类似,但需要注意权限问题,比如创建wiki目录时的权限设置。 接下来是数据库配置。用户需要安装配置PostgreSQL或MySQL,这部分步骤在CentOS 9上可能和CentOS 7有所不同,比如服务管理的命令(systemctl)是否一样,以及软件包的名称是否有变化。需要确保数据库服务启动,并创建对应的用户和数据库。 然后是修改Wiki.js配置文件config.yml,设置数据库连接、端口等信息。这里要注意CentOS 9的防火墙设置,可能需要开放相应的端口,比如3000默认端口或者通过Nginx反向代理的80端口。 最后,启动Wiki.js服务,并设置开机自启。可能使用systemd来管理服务,需要编写相应的service文件,确保服务能正确运行。另外,可能需要配置Nginx作为反向代理,引用中的例子用了Nginx,但用户是否需要这个步骤取决于具体需求。 另外,用户提到的引用中有使用Docker的方式部署,但在CentOS 9上是否推荐这种方式?如果用户更倾向于原生安装,可能需要忽略Docker的步骤,专注于手动安装。但Docker方式可能更简便,避免环境配置的问题,需要根据用户的选择来调整步骤。 还需要注意CentOS 9的软件仓库是否包含所需的依赖包,比如tar、wget等工具是否默认安装,如果没有,需要先安装这些工具。此外,SELinux和防火墙配置可能会影响Wiki.js的访问,需要适当调整策略或关闭相关限制。 最后,测试安装是否成功,可以通过curl访问本地端口,或者通过浏览器访问服务器的IP和端口,确保Wiki.js的界面正常显示。如果出现问题,需要检查日志文件,比如Wiki.js的日志或Nginx的错误日志,来排查问题所在。</think>### CentOS 9 安装 Wiki.js 分步指南 #### 一、安装系统依赖 1. **更新系统软件包** 执行以下命令更新系统: ```bash sudo dnf update -y ``` 2. **安装 Node.js** Wiki.js 要求 Node.js 版本为 **16.x 或 18.x**。通过以下步骤安装 Node.js 18: ```bash curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash - sudo dnf install -y nodejs ``` 验证安装: ```bash node -v # 应输出 v18.x.x ``` 3. **安装数据库** Wiki.js 支持 PostgreSQL、MySQL 等数据库。以 **PostgreSQL 15** 为例: ```bash sudo dnf install -y postgresql-server postgresql-contrib sudo postgresql-setup --initdb sudo systemctl enable postgresql --now ``` 创建数据库和用户: ```sql CREATE DATABASE wiki; CREATE USER wiki WITH PASSWORD 'your_password'; GRANT ALL PRIVILEGES ON DATABASE wiki TO wiki; ``` #### 二、下载并配置 Wiki.js 1. **下载安装包** 从 GitHub 获取最新版本(以 2.5.201 为例): ```bash wget https://github.com/Requarks/wiki/releases/download/2.5.201/wiki-js.tar.gz ``` 2. **解压文件** 创建目录并解压: ```bash sudo mkdir -p /var/wiki sudo tar xzf wiki-js.tar.gz -C /var/wiki cd /var/wiki ``` 3. **配置数据库连接** 复制示例配置文件并编辑: ```bash sudo cp config.sample.yml config.yml sudo vi config.yml ``` 修改以下部分: ```yaml db: type: postgres postgres: host: localhost port: 5432 user: wiki pass: "your_password" db: wiki ``` #### 三、配置反向代理(可选) 若需通过域名访问,建议使用 **Nginx** 作为反向代理: 1. **安装 Nginx** ```bash sudo dnf install -y nginx sudo systemctl enable nginx --now ``` 2. **创建 Nginx 配置文件** 在 `/etc/nginx/conf.d/wiki.conf` 中添加: ```nginx server { listen 80; server_name your_domain.com; location / { proxy_pass http://localhost:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ``` 重启 Nginx: ```bash sudo nginx -t && sudo systemctl restart nginx ``` #### 四、启动 Wiki.js 1. **运行服务** 直接启动: ```bash node server ``` 或使用 **PM2** 守护进程: ```bash sudo npm install -g pm2 pm2 start server.js --name "wiki" pm2 save pm2 startup ``` 2. **访问界面** 浏览器打开 `http://服务器IP:3000` 或 `http://your_domain.com`,按向导完成初始化配置[^2]。 #### 五、防火墙配置 开放必要端口: ```bash sudo firewall-cmd --permanent --add-port=3000/tcp # Wiki.js 默认端口 sudo firewall-cmd --permanent --add-service=http # Nginx 80端口 sudo firewall-cmd --reload ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

邓越浪Henry

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值