openiothub/gateway-go

gateway-go

镜像概述和主要用途

gateway-go是一款持续运行在局域网内的工具，用于接收https://github.com/OpenIoTHub/OpenIoTHub%E7%9A%84%E8%BF%9C%E7%A8%8B%E8%AE%BF%E9%97%AE%E8%AF%B7%E6%B1%82%EF%BC%88%E7%B1%BB%E4%BC%BCfrpc%EF%BC%89%E3%80%82%E5%8F%AA%E9%9C%80%E8%BF%90%E8%A1%8Cgateway-go%EF%BC%8C%E5%AE%83%E4%BC%9A%E6%98%BE%E7%A4%BA%E4%B8%80%E4%B8%AA***%EF%BC%8C%E4%BD%BF%E7%94%A8OpenIoTHub%E6%89%AB%E6%8F%8F%E8%AF%A5***%E6%B7%BB%E5%8A%A0%E6%AD%A4%E7%BD%91%E5%85%B3%E5%90%8E%EF%BC%8C%E5%8D%B3%E5%8F%AF%E9%80%9A%E8%BF%87OpenIoTHub%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%AE%BF%E9%97%AE%E5%B1%80%E5%9F%9F%E7%BD%91%E5%86%85%E6%89%80%E6%9C%89%E7%BD%91%E7%BB%9C%E7%AB%AF%E5%8F%A3%E5%92%8C%E6%9C%8D%E5%8A%A1%E3%80%82

核心功能和特性

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

使用场景和适用范围

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

使用方法和配置说明

NAS安装

https://www.synology.com

目前可通过Docker安装，参考视频教程：https://www.bilibili.com/video/BV1of4y1G7Jb

CasaOS、ZimaOS

直接从应用市场下载https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/Gateway-go

fnos

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

unRaid

目前可通过Docker安装，参考视频教程：https://www.bilibili.com/video/BV1EzWFeSEGC

https://www.qnap.com.cn/zh-cn

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

ugnas

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

https://www.zspace.cn

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

路由器安装

openwrt/entware/optware

sh
opkg update
opkg install gateway-go

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

预编译二进制安装

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

sh
$ brew install gateway-go

homebrew PR：https://github.com/Homebrew/homebrew-core/blob/master/Formula/gateway-go.rb

配置文件路径：

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 https://github.com/OpenIoTHub/scoop-bucket.git
$ scoop install gateway-go

deb/rpm：

从https://github.com/OpenIoTHub/gateway-go/v2/releases下载.deb或.rpm文件，分别使用dpkg -i和rpm -i安装。

配置文件路径：

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

手动安装：

从https://github.com/OpenIoTHub/gateway-go/v2/releases下载预编译二进制文件，复制到所需位置。

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
#
# https://gitee.com/OpenIoThub/mobile-lib-podspec
# 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=https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/
mvn deploy:deploy-file -Dfile=client.aar -DgroupId=cloud.iothub -DartifactId=gateway -Dversion=0.0.1 -Dpackaging=aar -DrepositoryId=github -Durl=https://maven.pkg.github.com/OpenIoTHub/gateway-go/v2

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 ***utils-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