安装

警告

Server Torii 目前仍在积极的添加新的功能，并且完善部分现有功能的配置。你已经可以用它来保护你的站点，但是在版本更新的时候，有可能会发生一些破坏性更新。因此，在更新的时候，请注意参考更新指南。

提示

安装前，请确保你的服务器已经安装了适当的环境，详情请参照环境准备

警告

如果您的服务器位于中华人民共和国境内。

您的服务器可能无法从 Github 和 Go 下载 Server Torii 源代码和相关依赖.

请注意，使用镜像站点可能会带来安全风险，请确保您信任所使用的镜像站点。

您可以将下面各命令的 git clone 命令替换为 GitHub 镜像站点的地址。

您可以通过设置GOPROXY 来使用 Go 模块代理，例如：使用 Goproxy.cn 作为 Go 模块代理：

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

前往 Goproxy.cn 获取更多信息

安装分为两部分 ngx_torii 和 server_torii

ngx_torii 是一个 Nginx 模块，是 server_torii 的连接器，用于将 Nginx 收到的请求发送给 server_torii 检查

安装 Sever_torii

mkdir -p /www/server_torii
cd /www/server_torii

下载 server_torii

git clone https://github.com/Rayzggz/server_torii.git
cd server_torii

参照配置指南修改配置文件

快速开始配置

使用Makefile编译 install 目标会在当前工作目录进行编译编译后的可执行程序将放置在当前目录下并且将 server_torii 添加到系统服务中最后会自动启动 server_torii 并将其添加到开机启动项中

如果希望以其他方式运行可以按照标准 go 程序的方式编译和运行

make install

接来在 Nginx 或 OpenResty 等 Nginx 兼容的 Web 服务上安装 ngx_torii 模块

编译安装 ngx_torii

如何获取编译参数

编译安装需要知道当前的 Nginx 的编译参数，通过运行 nginx -V 获取例如：

# nginx -V

nginx version: nginx/1.21.4
built by gcc 13.3.0 (Ubuntu 13.3.0-6ubuntu2~24.04) 
built with OpenSSL 1.1.1w  11 Sep 2023
TLS SNI support enabled
configure arguments: --user=www --group=www --prefix=/www/server/nginx --add-module=/www/server/nginx/src/ngx_devel_kit --add-module=/www/server/nginx/src/lua_nginx_module --add-module=/www/server/nginx/src/ngx_cache_purge --add-module=/www/server/nginx/src/nginx-sticky-module --with-openssl=/www/server/nginx/src/openssl --with-pcre=pcre-8.43 --with-http_v2_module --with-stream --with-stream_ssl_module --with-stream_ssl_preread_module --with-http_stub_status_module --with-http_ssl_module --with-http_image_filter_module --with-http_gzip_static_module --with-http_gunzip_module --with-ipv6 --with-http_sub_module --with-http_flv_module --with-http_addition_module --with-http_realip_module --with-http_mp4_module --with-http_auth_request_module --add-module=/www/server/nginx/src/ngx_http_substitutions_filter_module-master --with-ld-opt=-Wl,-E --with-cc-opt=-Wno-error --with-ld-opt=-ljemalloc --with-http_dav_module --add-module=/www/server/nginx/src/nginx-dav-ext-module

请使用 configure arguments: 后面的内容，下文中将使用 ARG 来代替这块内容。

ngx_torii 代码仓库： https://github.com/Rayzggz/ngx_torii

此项目基于Nginx内置模块 ngx_http_auth_request_module 进行了简单修改以支持 server_torii

使用 git clone https://github.com/Rayzggz/ngx_torii 获取代码

$ cd nginx-1.x.x
$ ./configure ARG --add-module=/path/to/ngx_torii
$ make
$ make install

宝塔面板自动安装 ngx_torii

警告

这个方法需要卸载当前的 Nginx 并重新安装，可能会对正在运行的服务造成影响

如希望尽量减少对服务的影响，并且当前 Nginx 在安装时选择的是编译安装，可以使用下面的“宝塔面板替换安装 ngx_torii”指南

在软件商店卸载Nginx
在软件商店安装Nginx 选择「编译安装」选项
「添加自定义模块」中添加 ngx_torii 模块

名称： ngx_torii
描述： Server Torii Nginx Module
参数： --add-module=/www/server/nginx/src/ngx_torii
前置脚本：

mkdir -p /www/server/nginx/src
cd /www/server/nginx/src
git clone https://github.com/Rayzggz/ngx_torii

按照宝塔的提示完成安装

宝塔面板替换安装 ngx_torii

警告

使用这个方法需要保证您当前的 Nginx 是通过宝塔面板编译安装的如果 /www/server/nginx/src 文件夹内存在源码文件，则说明当前 Nginx 是通过编译安装的