Download
tip
Seata Go v2.0.0 is the current stable release, covering AT, TCC, and XA modes with registry options for file, Nacos, and Etcd.
System Requirements
Item | Requirement / Notes |
---|---|
Go toolchain | Go 1.20 or newer with modules enabled (go env GOPATH configured) |
Seata Server | Seata Server 2.5.0+ reachable from your services (HTTP/2 enabled by default in 2.5.0) |
Registry / Config | File, Nacos, or Etcd v3 registry; optional config center via file or Nacos |
Database | MySQL 5.7/8.0 for AT & XA; Oracle supported through go-ora (XA) |
Operating system | Linux, macOS, Windows (amd64/arm64) |
Stable Version
Version | Source | Binary | Release Notes | Reference Docs |
---|---|---|---|---|
2.0.0 | apache-seata-go-2.0.0-incubating-src.tar.gz ASC SHA512 | apache-seata-go-2.0.0-incubating-bin.tar.gz ASC SHA512 | v2.0.0 changelog | Samples & docs |
- For upgrade guidance, follow the project README and keep module dependencies in sync with Seata Server.
- Older releases are available from the Seata Go archive.
Install via Go Modules
- (Optional) Pin a proxy for faster downloads:
go env -w GOPROXY=https://goproxy.cn,direct
. - Add the SDK to your module:
go get seata.apache.org/seata-go@v2.0.0
(records togo.mod
/go.sum
). - Lock the dependency explicitly by keeping
require seata.apache.org/seata-go v2.0.0
and runninggo mod tidy
. - Verify dependency integrity before committing:
go list seata.apache.org/seata-go/...
.
Verify the releases
It is crucial to verify the integrity of downloaded artifacts using GPG signatures or SHA checksums. Download the KEYS, .asc
, and .sha512
files directly from the Apache distribution directory rather than mirrors.
Verify Signatures
- Download the signatures KEYS and the desired release files with their
.asc
signatures. - Import the public keys:
gpg --import KEYS
- Validate each artifact, for example:
A result similar to the following indicates a valid signature:
gpg --verify apache-seata-go-2.0.0-incubating-src.tar.gz.asc apache-seata-go-2.0.0-incubating-src.tar.gz
gpg --verify apache-seata-go-2.0.0-incubating-bin.tar.gz.asc apache-seata-go-2.0.0-incubating-bin.tar.gzgpg: Signature made Tue Apr 29 12:11:09 2025 CST
gpg: using RSA key 775377BF271D659E591249CD63E269707E8BF0FB
gpg: Good signature from "xxx" [ultimate]
Verify Checksums
- Download the
.sha512
file corresponding to the artifact. - Run the checksum validation:
Output ending with
shasum -c apache-seata-go-2.0.0-incubating-src.tar.gz.sha512
shasum -c apache-seata-go-2.0.0-incubating-bin.tar.gz.sha512OK
confirms the archive is intact.
Additional Resources
- Seata Go repository: apache/incubator-seata-go
- Go samples: apache/incubator-seata-go-samples
- Configuration reference:
pkg/client/config.go
- Transaction mode overview: Seata documentation