From 53a1b40f2e66c8038a68a66382e1ece23d40e980 Mon Sep 17 00:00:00 2001 From: Minho Date: Fri, 26 May 2017 16:43:28 +0800 Subject: [PATCH] =?UTF-8?q?Created=20Windows=20=E4=B8=8B=E5=AE=89=E8=A3=85?= =?UTF-8?q?=E5=92=8C=E9=83=A8=E7=BD=B2MinDoc=20(markdown)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Windows-下安装和部署MinDoc.md | 112 ++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 Windows-下安装和部署MinDoc.md diff --git a/Windows-下安装和部署MinDoc.md b/Windows-下安装和部署MinDoc.md new file mode 100644 index 0000000..13fa412 --- /dev/null +++ b/Windows-下安装和部署MinDoc.md @@ -0,0 +1,112 @@ +# Windows 下安装和配置 MinDoc + +**如果你的服务器上没有安装golang程序请手动设置一个环境变量如下:键名为 ZONEINFO,值为MinDoc跟目录下的/lib/time/zoneinfo.zip 绝对路径。** + +**第一步 下载可执行文件** + +请从 [https://github.com/lifei6671/godoc/releases](https://github.com/lifei6671/godoc/releases) 下载最新版的可执行文件,一般文件名为 godoc_windows_amd.zip . + +**第二步 解压压缩包** + +请将刚才下载的文件解压,推荐使用好压解压到任意目录。建议不用用中文明明目录名称。 + +**第三步 创建数据库** + +如果你使用的 mysql 数据库,请创建一个编码为utf8mb4格式的数据库,如果没有GUI管理工具,推荐用下面的脚本创建: + +```sql +CREATE DATABASE mindoc_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; +``` +-------------------------------------------------------------------- + +如果你使用的是 sqlite 数据库,请将 conf/app.conf 中的数据库配置成如下: + +``` +db_adapter=sqlite3 +db_database=mindoc_db +``` + +**第四步 配置数据库** + +请将刚才解压目录下 conf/app.conf.example 重名为 app.conf。同时配置如下节点: + +```ini +#数据库配置 + +#mysql数据库的IP +db_host=127.0.0.1 + +#mysql数据库的端口号一般为3306 +db_port=3306 + +#刚才创建的数据库的名称 +db_database=mindoc_db + +#访问数据库的账号和密码 +db_username=root +db_password=123456 + +``` + +在 MinDoc 根目录下使用命令行执行如下命令,用于初始化数据库: + +```bash +godoc_windows_amd64.exe install +``` + +**第五步 启动程序** + +如果你设置了环境变量,但是没有重启电脑,请在cmd命令行启动 godoc_windows_amd64.exe 程序。 + +如果你设置了环境变量,并且重启了电脑,双击 godoc_windows_amd64.exe 即可。 + +稍等一分钟,程序会自动初始化数据库,并创建一个超级管理员账号:admin 密码:123456 + +此时访问 http://localhost:8181 就能访问 MinDoc 了。 + +**第六步 配置代理** + +这一步可选,如果你不想用端口号访问 MinDoc 就需要配置一个代理了。 + +推荐使用nginx做前端代理,当然,也可以用IIS做代理。 + +IIS的代理教程请参见 : [http://blog.csdn.net/yuanguozhengjust/article/details/23576033?utm_source=tuicool&utm_medium=referral](http://blog.csdn.net/yuanguozhengjust/article/details/23576033?utm_source=tuicool&utm_medium=referral) + +Nginx 代理的配置文件如下: + +```ini +server { + listen 80; + + #此处应该配置你的域名: + server_name webhook.iminho.me; + + charset utf-8; + + #此处配置你的访问日志,请手动创建该目录: + access_log /var/log/nginx/webhook.iminho.me/access.log; + + location ~ .*\.(ttf|woff2|eot|otf|map|swf|svg|gif|jpg|jpeg|bmp|png|ico|txt|js|css)$ { + + #此处将路径执行 MinDoc 的跟目录 + root "/var/go/godoc"; + expires 30m; + } + + + location / { + try_files /_not_exists_ @backend; + } + + # 这里为具体的服务代理配置 + location @backend { + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $http_host; + proxy_set_header X-Forwarded-Proto $scheme; + + #此处配置 MinDoc 程序的地址和端口号 + proxy_pass http://127.0.0.1:8181; + } +} + +```