- vanilla nginx + Rust 动态模块(取代 OpenResty+Lua),共享内存为运行期真源 - 三域名分流 18098 ssl:mdm 管理台 / lm LLM 代理 / *.dm 企业转发,共用 *.mayishangshu.cn 通配符证书(证书不入库) - LLM 统一出口:同 Key 鉴权、上游 Key 替换、白名单、限流配额、SSE - 回归夹具 tests/(网关 55 + LLM 34 = 89 断言,夹具 cp 覆盖重置) - 文档:readme(16 章)+ CLAUDE.md + conf/tls/README(acme.sh 证书管理、hairpin 环回链路)
352 lines
9.6 KiB
Bash
352 lines
9.6 KiB
Bash
#!/bin/sh
|
|
#
|
|
# Copyright 2025 Nginx, Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
#
|
|
# Utility library for integration of ngx-rust modules into the NGINX build
|
|
# configuration.
|
|
#
|
|
# Usage:
|
|
#
|
|
# In "config",
|
|
#
|
|
# ```sh
|
|
# . $ngx_addon_dir/auto/rust
|
|
#
|
|
# # ngx_addon_name determines the build directory and should be set before
|
|
# # any modules are defined
|
|
#
|
|
# ngx_addon_name="example"
|
|
#
|
|
# if [ $HTTP = YES ]; then
|
|
# # Regular NGINX module options,
|
|
# # http://nginx.org/en/docs/dev/development_guide.html#adding_new_modules
|
|
#
|
|
# ngx_module_type=HTTP
|
|
# # Should match the "ngx_module_t" static name(s) exported from the Rust code
|
|
# ngx_module_name=ngx_http_example_module
|
|
# ngx_module_incs=
|
|
# ngx_module_deps=
|
|
# ngx_module_libs=
|
|
#
|
|
# # Options specific to ngx-rust modules
|
|
#
|
|
# # Target type: LIB or EXAMPLE
|
|
# ngx_rust_target_type=LIB
|
|
#
|
|
# # Target name: crate name, lib.name or example.name
|
|
# ngx_rust_target_name=example
|
|
#
|
|
# # Whitespace-separated list of cargo features.
|
|
# # "default" should be specified explicitly if required.
|
|
# ngx_rust_target_features=
|
|
#
|
|
# ngx_rust_module
|
|
# fi
|
|
# ```
|
|
#
|
|
# In "config.make",
|
|
#
|
|
# ```sh
|
|
# ngx_addon_name="example"
|
|
# ngx_cargo_manifest=$ngx_addon_dir/Cargo.toml
|
|
#
|
|
# # generate Makefile section for all the modules configured earlier
|
|
#
|
|
# ngx_rust_make_modules
|
|
# ```
|
|
#
|
|
# The following environment variables can affect the generated Makefile:
|
|
#
|
|
# - NGX_CARGO sets the "cargo" binary to use, e.g. NGX_CARGO=cargo-1.82
|
|
# - NGX_RUST_TARGET passes the --target to the Rust compiler if set
|
|
# - NGX_RUSTC_OPT passes additional options to "cargo rustc"
|
|
|
|
# Prevent duplicate invocation unless it is a newer library version
|
|
if [ "${NGX_RUST_AUTO_VER:-0}" -ge 1 ]; then
|
|
return
|
|
fi
|
|
|
|
NGX_RUST_AUTO_VER=1
|
|
|
|
echo $ngx_n "checking for Rust toolchain ...$ngx_c"
|
|
|
|
NGX_CARGO=${NGX_CARGO:-cargo}
|
|
|
|
NGX_RUST_VER=$($NGX_CARGO version 2>&1 \
|
|
| grep 'cargo 1\.[0-9][0-9]*\.[0-9]*' 2>&1 \
|
|
| sed -e 's/^.* \(1\.[0-9][0-9]*\.[0-9][0.9]*.*\)/\1/')
|
|
|
|
NGX_RUST_VERSION=${NGX_RUST_VER%% *}
|
|
|
|
if [ -z "$NGX_RUST_VERSION" ]; then
|
|
echo " not found"
|
|
echo
|
|
echo $0: error: cargo binary $NGX_CARGO is not found
|
|
echo
|
|
exit 1
|
|
fi
|
|
|
|
echo " found"
|
|
echo " + Rust version: $NGX_RUST_VER"
|
|
|
|
case "$NGX_MACHINE" in
|
|
|
|
amd64)
|
|
RUST_TARGET_ARCH=x86_64
|
|
;;
|
|
|
|
arm64)
|
|
RUST_TARGET_ARCH=aarch64
|
|
;;
|
|
|
|
i?86)
|
|
RUST_TARGET_ARCH=i686
|
|
;;
|
|
|
|
*)
|
|
RUST_TARGET_ARCH=$NGX_MACHINE
|
|
;;
|
|
|
|
esac
|
|
|
|
case "$NGX_PLATFORM" in
|
|
|
|
OpenBSD:*)
|
|
# ld: error: undefined symbol: _Unwind_...
|
|
RUST_LIBS="$RUST_LIBS -lutil"
|
|
RUST_LIBS="$RUST_LIBS -lexecinfo"
|
|
RUST_LIBS="$RUST_LIBS -lc++abi"
|
|
;;
|
|
|
|
win32)
|
|
case "$NGX_CC_NAME" in
|
|
|
|
msvc)
|
|
# as suggested by rustc --print native-static-libs,
|
|
# excluding entries already present in CORE_LIBS
|
|
RUST_LIBS="$RUST_LIBS bcrypt.lib" # ???
|
|
RUST_LIBS="$RUST_LIBS ntdll.lib" # std::io, std::sys::pal::windows
|
|
RUST_LIBS="$RUST_LIBS userenv.lib" # std::env::home_dir
|
|
RUST_LIBS="$RUST_LIBS dbghelp.lib" # backtrace symbolization
|
|
|
|
NGX_RUST_TARGET=${NGX_RUST_TARGET:-$RUST_TARGET_ARCH-pc-windows-msvc}
|
|
;;
|
|
|
|
gcc | clang)
|
|
RUST_LIBS="$RUST_LIBS -lbcrypt"
|
|
RUST_LIBS="$RUST_LIBS -lntdll"
|
|
RUST_LIBS="$RUST_LIBS -luserenv"
|
|
RUST_LIBS="$RUST_LIBS -ldbghelp"
|
|
# gnullvm on arm64?
|
|
NGX_RUST_TARGET=${NGX_RUST_TARGET:-$RUST_TARGET_ARCH-pc-windows-gnu}
|
|
;;
|
|
|
|
esac
|
|
;;
|
|
|
|
esac
|
|
|
|
|
|
# Prepare cargo configuration file
|
|
|
|
if [ "$NGX_DEBUG" = YES ]; then
|
|
ngx_cargo_default_profile=ngx-debug
|
|
else
|
|
ngx_cargo_default_profile=ngx-release
|
|
fi
|
|
|
|
ngx_cargo_config=$NGX_OBJS/.cargo/config.toml
|
|
ngx_cargo_profile=${ngx_cargo_profile:-$ngx_cargo_default_profile}
|
|
|
|
mkdir -p "$NGX_OBJS/.cargo"
|
|
|
|
cat << END > "$ngx_cargo_config"
|
|
|
|
[profile.ngx-debug]
|
|
inherits = "dev"
|
|
|
|
[profile.ngx-release]
|
|
inherits = "release"
|
|
strip = "none"
|
|
|
|
# compatibility with LIBC=-MT set in auto/cc/msvc
|
|
[target.aarch64-pc-windows-msvc]
|
|
rustflags = ["-C", "target-feature=+crt-static"]
|
|
|
|
[target.i686-pc-windows-msvc]
|
|
rustflags = ["-C", "target-feature=+crt-static"]
|
|
|
|
[target.x86_64-pc-windows-msvc]
|
|
rustflags = ["-C", "target-feature=+crt-static"]
|
|
|
|
[env]
|
|
NGINX_BUILD_DIR = { value = ".", force = true, relative = true }
|
|
END
|
|
|
|
if [ "$NGX_PLATFORM" = win32 ] && command -v cygpath >/dev/null; then
|
|
printf >> "$ngx_cargo_config" 'NGINX_SOURCE_DIR = "%s"\n' \
|
|
"$(cygpath -m "$PWD")"
|
|
else
|
|
printf >> "$ngx_cargo_config" 'NGINX_SOURCE_DIR = "%s"\n' "$PWD"
|
|
fi
|
|
|
|
|
|
# Reconstructs path to a static lib built with cargo rustc,
|
|
# relative to the --target-dir
|
|
|
|
ngx_rust_target_path () {
|
|
ngx_rust_obj=$(echo "$ngx_rust_target_name" | tr - _)
|
|
|
|
case "$NGX_CC_NAME" in
|
|
|
|
msvc)
|
|
ngx_rust_obj=${ngx_rust_obj}.lib
|
|
;;
|
|
|
|
*)
|
|
ngx_rust_obj=lib${ngx_rust_obj}.a
|
|
;;
|
|
|
|
esac
|
|
|
|
if [ "$ngx_rust_target_type" = EXAMPLE ]; then
|
|
ngx_rust_obj=examples/$ngx_rust_obj
|
|
fi
|
|
|
|
echo "${NGX_RUST_TARGET:+$NGX_RUST_TARGET/}$ngx_cargo_profile/$ngx_rust_obj"
|
|
}
|
|
|
|
|
|
# Registers a module in the buildsystem.
|
|
# In addition to the regular auto/module parameters, the following variables
|
|
# are expected to be set:
|
|
#
|
|
# ngx_rust_target_type=LIB|EXAMPLE
|
|
# ngx_rust_target_name=<library or example name[^1]>
|
|
# ngx_rust_target_features=<list of cargo features>
|
|
#
|
|
# [^1]: https://doc.rust-lang.org/cargo/reference/cargo-targets.html#the-name-field)
|
|
|
|
ngx_rust_module () {
|
|
ngx_addon_id=$(echo "$ngx_addon_name" | sed -e 's/[^A-Za-z0-9_]/_/g')
|
|
ngx_rust_obj=$NGX_OBJS/$ngx_addon_id/$(ngx_rust_target_path)
|
|
|
|
ngx_module_deps_saved=$ngx_module_deps
|
|
ngx_module_deps="$ngx_rust_obj $ngx_module_deps"
|
|
|
|
ngx_module_libs_saved=$ngx_module_libs
|
|
ngx_module_libs="$ngx_rust_obj $ngx_module_libs $RUST_LIBS"
|
|
|
|
if [ -n "$ngx_rust_target_features" ]; then
|
|
eval ${ngx_addon_id}_RUST_FEATURES=\"\$${ngx_addon_id}_RUST_FEATURES \
|
|
$ngx_rust_target_features\"
|
|
fi
|
|
|
|
. auto/module
|
|
|
|
ngx_rust_target=$ngx_rust_target_type:$ngx_rust_target_name
|
|
|
|
# module deps are usually added to the object file targets, but we don't have any
|
|
|
|
if [ "$ngx_module_link" = DYNAMIC ]; then
|
|
# remember the dynamic module name and generate dependency later
|
|
ngx_rust_target=$ngx_rust_target:$ngx_module
|
|
else
|
|
# add dependency to the binary target
|
|
LINK_DEPS="$LINK_DEPS $ngx_rust_obj"
|
|
fi
|
|
|
|
eval ${ngx_addon_id}_RUST_TARGETS=\"\$${ngx_addon_id}_RUST_TARGETS \
|
|
$ngx_rust_target\"
|
|
|
|
ngx_module_deps=$ngx_module_deps_saved
|
|
ngx_module_libs=$ngx_module_libs_saved
|
|
}
|
|
|
|
|
|
# Writes a Makefile fragment for all the modules configured for "ngx_addon_name"
|
|
|
|
ngx_rust_make_modules () {
|
|
ngx_addon_id=$(echo "$ngx_addon_name" | sed -e 's/[^A-Za-z0-9_]/_/g')
|
|
ngx_cargo_manifest=${ngx_cargo_manifest:-"$ngx_addon_dir/Cargo.toml"}
|
|
|
|
eval ngx_rust_features="\$${ngx_addon_id}_RUST_FEATURES"
|
|
eval ngx_rust_targets="\$${ngx_addon_id}_RUST_TARGETS"
|
|
|
|
for target in $ngx_rust_targets; do
|
|
IFS=':' read -r ngx_rust_target_type ngx_rust_target_name ngx_rust_module_name <<END
|
|
$target
|
|
END
|
|
|
|
ngx_rust_make_module
|
|
done
|
|
}
|
|
|
|
|
|
# Writes a Makefile fragment for a single module specified by
|
|
# "ngx_addon_name", "ngx_rust_target_type" and "ngx_rust_target_name"
|
|
|
|
ngx_rust_make_module () {
|
|
ngx_addon_id=$(echo "$ngx_addon_name" | sed -e 's/[^A-Za-z0-9_]/_/g')
|
|
ngx_rust_obj=$NGX_OBJS/$ngx_addon_id/$(ngx_rust_target_path)
|
|
|
|
ngx_rustc_module_opt=
|
|
if [ "$ngx_rust_target_type" = EXAMPLE ]; then
|
|
ngx_rustc_module_opt="--example $ngx_rust_target_name"
|
|
fi
|
|
|
|
if [ -z "$ngx_rust_phony_emitted" ]; then
|
|
ngx_rust_phony_emitted=1
|
|
|
|
# Make cannot track the Rust module source and dependency changes,
|
|
# so we defer the task to cargo and invoke it unconditionally.
|
|
#
|
|
# We have to use the pseudotarget instead of .PHONY for better
|
|
# compatibility with various Make implementations.
|
|
cat <<END >> $NGX_MAKEFILE
|
|
|
|
.NGX_RUST_PHONY: ;
|
|
|
|
END
|
|
fi
|
|
|
|
cat << END >> $NGX_MAKEFILE
|
|
|
|
$ngx_rust_obj: .NGX_RUST_PHONY
|
|
$NGX_CARGO rustc \\
|
|
--config $ngx_cargo_config \\
|
|
--crate-type staticlib \\
|
|
--manifest-path "$ngx_cargo_manifest" \\
|
|
--no-default-features \\
|
|
--profile $ngx_cargo_profile \\
|
|
${NGX_RUST_TARGET:+--target $NGX_RUST_TARGET} \\
|
|
--target-dir $NGX_OBJS/$ngx_addon_id \\
|
|
--features "$ngx_rust_features" \\
|
|
$ngx_rustc_module_opt $NGX_RUSTC_OPT
|
|
|
|
END
|
|
|
|
# Ensure that the "auto"-generated dynamic module target depends on the
|
|
# static library. Normally this is achieved by attaching ADDON_DEPS to
|
|
# the module object files, but we don't have any suitable C sources.
|
|
|
|
if [ -n "$ngx_rust_module_name" ]; then
|
|
cat << END >> $NGX_MAKEFILE
|
|
$NGX_OBJS$ngx_dirsep$ngx_rust_module_name$ngx_modext: $ngx_rust_obj
|
|
END
|
|
fi
|
|
}
|