gateway-go

镜像概述和主要用途

gateway-go是一款持续运行在局域网内的工具，用于接收OpenIoTHub的远程访问请求（类似***）。只需运行gateway-go，它会显示一个***，使用OpenIoTHub扫描该***添加此网关后，即可通过OpenIoTHub客户端访问局域网内所有网络端口和服务。

核心功能和特性

• 持续运行在局域网，接收远程访问请求
• ***便捷添加机制，简化配置流程
• 多平台支持：兼容多种NAS设备、路由器及操作系统
• 支持Docker部署，快速集成到现有环境
• 提供预编译二进制包，支持homebrew、snapcraft等多种安装方式

使用场景和适用范围

• 家庭网络远程访问：无需公网IP即可远程访问家庭局域网设备
• NAS设备管理：通过OpenIoTHub远程管理Synology、QNAP等品牌NAS
• 路由器集成：在OpenWrt等路由器系统中部署，实现整个网络的远程访问
• 跨平台设备统一管理：适用于CasaOS、ZimaOS等多种操作系统环境

使用方法和配置说明

NAS安装

Synology

目前可通过Docker安装，参考视频教程：[***]

CasaOS、ZimaOS

直接从应用市场下载gateway-go

fnos

目前可通过Docker安装，参见Docker运行

unRaid

目前可通过Docker安装，参考视频教程：[***]

QNAP

目前可通过Docker安装，参见Docker运行

ugnas

目前可通过Docker安装，参见Docker运行

zspace

目前可通过Docker安装，参见Docker运行

路由器安装

openwrt/entware/optware

sh
opkg update
opkg install gateway-go

使用快照分支获取最新版本：[***]

预编译二进制安装

homebrew（可能不是最新版本）：

sh
$ brew install gateway-go

homebrew PR：gateway-go

配置文件路径：

text
/usr/local/etc/gateway-go/gateway-go.yaml

snapcraft：

sh
$ sudo snap install gateway-go

配置文件路径：

text
/root/snap/gateway-go/current/gateway-go.yaml

scoop：

sh
$ scoop bucket add OpenIoTHub [***]
$ scoop install gateway-go

deb/rpm：

从发布页面下载.deb或.rpm文件，分别使用dpkg -i和rpm -i安装。

配置文件路径：

text
/etc/gateway-go/gateway-go.yaml

手动安装：

从发布页面下载预编译二进制文件，复制到所需位置。

Docker运行

可在Docker容器中使用，执行以下命令，控制台将显示用于添加的***：

sh
$ docker run -it --net=host openiothub/gateway-go:latest

镜像通常包含最新稳定版Go环境。

构建动态/静态库

shell
# 构建并推送移动库
# 安装gomobile（系统命令行）
go install golang.org/x/mobile/cmd/gobind@latest
go install golang.org/x/mobile/cmd/gomobile@latest
gomobile init
gomobile version
go get -u golang.org/x/mobile/...
#
export GO111MODULE="off"
gomobile bind -target=android  -o gateway.aar
gomobile bind -ldflags '-w -s -extldflags "-lresolve"' --target=ios,macos,iossimulator -o OpenIoTHubGateway.xcframework ./client
#
# [***]
# git tag -a 0.0.1 -m '0.0.1'
# git push --tags
# pod trunk push ./OpenIoTHubGateway.podspec --skip-import-validation --allow-warnings
#
mvn gpg:sign-and-deploy-file -DrepositoryId=ossrh -Dfile=gateway.aar -DpomFile=gateway.pom -Durl=[***]
mvn deploy:deploy-file -Dfile=client.aar -DgroupId=cloud.iothub -DartifactId=gateway -Dversion=0.0.1 -Dpackaging=aar -DrepositoryId=github -Durl=[***]

shell
# 构建windows dll
echo "building windows dll"
# brew install mingw-w64
# sudo apt-get install binutils-mingw-w64
# shellcheck disable=SC2034
export CGO_ENABLED=1
export CC=x86_64-w64-mingw32-gcc
export CXX=x86_64-w64-mingw32-g++
export GOOS=windows GOARCH=amd64
go build -tags windows -ldflags=-w -trimpath -o ./build/windows/gateway_amd64.dll -buildmode=c-shared main.go

shell
# 构建linux/android so文件
echo "building linux/android so file"
# linux和Android共用动态链接库
export CGO_ENABLED=1
export GOARCH=amd64
export GOOS=linux
go build -tags linux -ldflags=-w -trimpath -o build/linux/libgateway_amd64.so -buildmode c-shared main.go
# shellcheck disable=SC2034
export CGO_ENABLED=1
export GOARCH=arm64
export GOOS=linux
# sudo apt install gcc-aarch64-linux-gnu
export CC=aarch64-linux-gnu-gcc
## sudo apt install g++-aarch64-linux-gnu
# export CXX=aarch64-linux-gnu-g++
## sudo apt-get install binutils-aarch64-linux-gnu
# export AR=aarch64-linux-gnu-ar
go build -tags linux -ldflags=-w -trimpath -o build/linux/libgateway_arm64.so -buildmode c-shared main.go