# gateway-go

**Repository Path**: gitsharp/gateway-go

## Basic Information

- **Project Name**: gateway-go
- **Description**: 语言实现的内网网关客户端，作用类似 frpc。
部署在内网局域网持续运行，用于实现**内网穿透、P2P 远程访问**，把局域网内设备 / 端口暴露给 OpenIoTHub 平台远程访问；运行后输出二维码，云亿连 App 扫码即可绑定网关，远程访问该网关所在局域网的各类服务与 IoT 设备Gitee
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gateway-go
🇺🇸English | 🇨🇳[中文](https://docs.iothub.cloud/gateway/index.html)
#### gateway-go is continuously running on the LAN to receive remote access requests for [OpenIoTHub](https://github.com/OpenIoTHub/OpenIoTHub) like frpc
###### Just run gateway-go,gateway-go showing a QR code, then use [OpenIoTHub](https://github.com/OpenIoTHub/OpenIoTHub) scan this QR code add this gateway-go, now you can access all network port and service from OpenIoTHub client

[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-white.svg)](https://snapcraft.io/gateway-go)

You can install the pre-compiled binary (in several different ways),
use Docker.

Here are the steps for each of them:
## NAS Install

#### [synology](https://www.synology.com)
Currently, you can [install it using Docker](https://www.bilibili.com/video/BV1of4y1G7Jb)
#### [CasaOS](https://www.casaos.io)、[ZimaOS](https://www.zimaspace.com)
Download directly from the app market [gateway-go](https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/Gateway-go)
#### [fnos](https://www.fnnas.com)
Currently, you can [install it using Docker](#running-with-docker)
#### [unRaid](https://unraid.net)
Currently, you can [install it using Docker](https://www.bilibili.com/video/BV1EzWFeSEGC)
#### [QNAP](https://www.qnap.com.cn/zh-cn)
Currently, you can [install it using Docker](#running-with-docker)
#### [ugnas](https://www.ugnas.com)
Currently, you can [install it using Docker](#running-with-docker)
#### [zspace](https://www.zspace.cn)
Currently, you can [install it using Docker](#running-with-docker)
## Router Install

#### [openwrt/entware/optware](https://openwrt.org/)
```sh
opkg update
opkg install gateway-go
```
#### use snapshot branch：https://downloads.openwrt.org/snapshots/ to get the latest version

## Install the pre-compiled binary

**homebrew** (may not be the latest version):

```sh
$ brew install gateway-go
```
homebrew pr [gateway-go](https://github.com/Homebrew/homebrew-core/blob/master/Formula/gateway-go.rb)
>config file :
>```text
> /usr/local/etc/gateway-go/gateway-go.yaml
>```


**snapcraft**:

```sh
$ sudo snap install gateway-go
```
>config file :
>```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**:

Download the `.deb` or `.rpm` from the [releases page][releases] and
install with `dpkg -i` and `rpm -i` respectively.  
>config file :
>```text
> /etc/gateway-go/gateway-go.yaml
>```

**manually**:

Download the pre-compiled binaries from the [releases page][releases] and
copy to the desired location.

## Running with Docker

You can also use it within a Docker container. To do that, you'll need to
execute something more-or-less like the following, console will show a QR code for adding:

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

Note that the image will almost always have the last stable Go version.

[releases]: https://github.com/OpenIoTHub/gateway-go/v2/releases
## Build dynamic/static Library
```shell
#build and push mobile lib
#install gomobile(at system cli)
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 pus --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
#for build 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
#for build linux/android so file
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
```