====== DokuWiki安装指南 ======

**如果已经安装有 DokuWiki，请参考[[install:upgrade|升级说明]]**

请你按照说明操作。如果你遇到问题或者觉得这些指示不够详细，请点击其中的链接来了解更多：

  * **步骤0:** 确认服务器是否符合[[requirements|要求]]。
  * **步骤1:**  从[[http://download.dokuwiki.org/|下载页面]]下载最新版的dokuwiki。
  * **步骤2:** //安装之前//先阅读[[security|安全页面]]，要仔细核对；如果有疑问，请在[[mailinglist]]中咨询。
  * **步骤3:**  解压缩下载的压缩包，并上传/复制到你的网站空间中。
  * **步骤4:** 通过浏览器访问你的 DokuWiki 中的 install.php，并按照页面给出的提示进行。（更多信息，查看[[installer|安装]]页面）
  * **步骤5:**  浏览[[manual|手册]]来发掘dokuwiki的功能，祝您使用愉快。

[[:install:screencast|DokuWiki 安装视频]]展示了如何安装到共享虚拟主机，其他安装也可参考。如果没有虚拟主机，可以查看我们的[[hosting|主机合作商]]找一个提前安装好 DokuWiki 的服务器。

如果你想要构建多个 Wiki，就可以创建一个 DokuWiki 农场，这等同于多个站点。关于这方面说明参见[[farms|农场]]。

===== 更详细的指令 =====

如果你遇到问题，需要更详细的说明，参考：

  * [[..zh:install:unpacking|解压.tar文件夹]]
  * [[..install:permissions|如何设置权限]]
  * [[..install:hosted|在主机空间安装 DokuWiki]]
  * [[installer|install.php 说明]]
  * [[zh:install:upgrade|从旧版本升级(中文)]]
  * [[FAQ|常见问题]]

==== 不同操作系统的配置参数 ====

  * [[https://wiki.alpinelinux.org/wiki/DokuWiki|Alpine Linux]]
  * [[https://wiki.archlinux.org/index.php/Dokuwiki|Arch Linux]]
  * [[install:CentOS]]
  * [[install:Debian]]
  * [[install:Fedora]]
  * [[install:FreeBSD]]
  * [[install:Gentoo]]
  * [[install:MacOSX]] 或 [[install:mac_alt]]
  * [[install:OpenBSD]]
  * [[install:OpenSolaris]]
  * [[install:openSUSE]]
  * [[https://wiki.qnap.com/wiki/Dokuwiki|QNAP NAS]]
  * [[install:Solaris]]
  * [[install:Ubuntu|Ubuntu]]
  * [[install:Windows]]
  * [[https://www.deepin.org/|Deepin Linux]]

==== 各种网络服务器配置参数 ====

    * [[install:Apache]]
    * [[install:darklight]]
    * [[install:Hiawatha]]
    * [[install:IIS]]
    * [[install:Lighttpd]]
    * [[install:Mongoose]]
    * [[install:Nanoweb]]
    * [[install:nginx]]
    * [[install:OpenLiteSpeed]]
    * [[install:caddy|Caddy(v2)]]

==== 网络主机参数 ====

  * [[hosting|主机合作商]]提供了预置 DokuWiki 安装
  * DokuWiki 安装在……
    * [[install:Amazone EC2|Amazon EC2]]
    * [[install:civihosting.com|CiviHosting]]
    * [[install:dreamhost|Dreamhost]]
    * [[install:free.fr|free.fr]]
    * [[install:godaddy.com|GoDaddy]]
    * [[install:hosted|Hosted Webspace]]
    * [[install:azurewebsites|Microsoft Azure 网络应用服务]]
    * [[install:ovh.com|ovh.com]]
    * [[install:sourceforge|SourceForge]]
    * [[install:strato|Strato and 1&1]]

有些网络主机已经将 DokuWiki 作为他们的捆绑安装包，所以可以自动安装。

==== 备用安装方法 =====

    * [[https://github.com/KissConsult/dokuwiki|IBM Cloud]] 是一个混合云平台，你可以在其上点击带有Bitnami图表的kubernetes集群来安装Dokuwiki。
    * [[https://cloudron.io|Cloudron]] 是一个完整的解决方案，用于在服务器上运行应用程序并使它们保持最新和安全。 
    * 这里是 [[https://cloudron.io/appstore.html#org.dokuwiki.cloudronapp|DokuWiki App]] 对于Cloudron。他们积极跟踪DokuWiki的发布 ([[https://git.cloudron.io/cloudron/dokuwiki-app|source]]) 并推送自动更新。 [[https://my.demo.cloudron.io/|Demo]] (用户名称: cloudron 密码: cloudron)
    * [[install:downloader|DokuWiki Downloader]] -- 负责下载和安装 DokuWiki 的单个脚本
    * [[http://www.turnkeylinux.org/dokuwiki|TurnKey DokuWiki Appliance]] -- 基于 Ubuntu 的免费开源虚拟设备，易于使用且轻量级。每天自动更新最新的安全补丁。在几分钟内部署到虚拟机、裸机或云中。这里 [[http://www.turnkeylinux.org/|TurnKey Linux Virtual Appliance Library]].
    * [[install:dokuwiki_on_a_stick|DokuWiki on a Stick]] -- 直接从 U 盘运行 DokuWiki
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- 一个部署DokuWiki的安装程序以及运行它所需的所有内容（Apache，PHP）。适用于 Windows、Linux、Mac x86、Mac PPC、Solaris x86 和 Solaris SPARC。
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Module]] -- 一个安装程序，如果您使用的是Linux，则在LAMPStack之上部署DokuWiki，如果您使用Mac，Windows或Solaris，则在MAMPStack，WAMPStack或SAMPstack之上部署，允许与其他应用程序模块共享数据库，Web服务器和语言运行时。
    * [[http://sourceforge.net/projects/desktopwiki/|Desktop Wiki]] -- 另一个便携式DokuWiki，但它似乎没有维护（自2013年以来没有更新）
    * [[devel:git#maintaining_a_stable_version_with_git|使用 Git 处理安装]]
    * [[https://sourceforge.net/projects/dokuwikispatial/files/DokuWiki%20portable/|使用统一服务器PHP MicroServer的便携式DokuWiki]]
    * [[https://www.synology.com/|Synology NAS]] 操作系统“Disk Station Manager”提供DokuWiki软件包，便于安装
    * 对于本地桌面wiki（在 Mac 上），请使用 [[PHP 内置网络服务器]].

===== PHP suhosin 扩展陷阱 =====

如果你的 PHP 安装有[[https://suhosin.org/stories/index.html|suhosin 扩展]]，记得要设置 ''suhosin.post.disallow_nul'' 和在 ''php.ini'' 里设置''suhosin.request.disallow_nul'' 为 0，否则编辑页和插件页都不工作。（编辑页面会循环回退到编辑状态，插件页的安装/更新按钮不工作）

你可以通过在服务器新建 ''test.php'' 页，内容如下：

''<?php phpinfo(); ?>''

然后访问该页。

如果虚拟主机不能满足 DokuWiki 安装要求，请询问供应商沟通。

===== 它已经运行了！然后该怎么办？ =====

当一切都设置好并且运行之后，下面是你可能需要做的：

  * 再检查一遍[[..security|安全]]页面
  * 考虑启用[[..rewrite|URL重写]]
  * 为您的内容选择一个许可证 -- 编辑在dokuwiki/lib/tpl/default文件夹内的''footer.html''来显示所拥有的许可证。
  * 为你的内容选择一个许可证---使用配置[[config:license]]或者编辑 dokuwiki/lib/tpl/...文件夹内的 ''footer.html''（如果你的模板没有使用DokuWiki 2009-02-14 引入的 ''tpl_licence()''）
  * 在[[DokuWiki]]的[[dokuinstall|userpage]]告诉一下大家你在哪里在如何使用本软件
  * 订阅 [[newsletter]]
  * 阅读
    * [[faq|常见问题]]
    * [[zh:tips:maintenance|必要的每日维护]]
    * [[tips|小技巧]]，尤其是在安装后做[[tips:tailorwikirules|最佳实践]]。

如果你安装 DokuWiki 时遇到了问题，然后仔细检查了上面的每一步：

  * 重新[[https://download.dokuwiki.org/|下载源码]]确保下载正确
  * 重新上传---FTP经常会出现问题。 上传压缩包，然后在服务器解压要比直接上传解压后的文件保险
  * 两到三次检查[[install:permissions|文件和文件夹的权限]]--这也是很多问题的 问题**多发地**
  * 在[[https://forum.dokuwiki.org/t/install-config|安装论坛]]提问题之前要确保已经[[https://forum.dokuwiki.org/|检索]]过问题，并且没有答案。