{"id":13693230,"url":"https://github.com/multiformats/go-multiaddr","last_synced_at":"2025-05-14T02:02:26.477Z","repository":{"id":18309450,"uuid":"21488145","full_name":"multiformats/go-multiaddr","owner":"multiformats","description":"Composable and future-proof network addresses","archived":false,"fork":false,"pushed_at":"2025-04-14T18:57:27.000Z","size":1288,"stargazers_count":283,"open_issues_count":34,"forks_count":117,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-04-15T08:45:02.156Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/multiformats/multiaddr","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/multiformats.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-07-04T06:53:02.000Z","updated_at":"2025-03-28T18:03:45.000Z","dependencies_parsed_at":"2024-01-06T09:24:01.699Z","dependency_job_id":"edafb89b-4a28-44ee-b34b-011e6de3081d","html_url":"https://github.com/multiformats/go-multiaddr","commit_stats":{"total_commits":456,"total_committers":46,"mean_commits":9.91304347826087,"dds":0.7960526315789473,"last_synced_commit":"37363a08950edeb2dbd2ff8448e26048c84e59a0"},"previous_names":["jbenet/go-multiaddr"],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiformats%2Fgo-multiaddr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiformats%2Fgo-multiaddr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiformats%2Fgo-multiaddr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiformats%2Fgo-multiaddr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/multiformats","download_url":"https://codeload.github.com/multiformats/go-multiaddr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052658,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T17:01:07.208Z","updated_at":"2025-05-14T02:02:26.441Z","avatar_url":"https://github.com/multiformats.png","language":"Go","funding_links":[],"categories":["开源类库","Open source library","Go"],"sub_categories":["网络","The Internet"],"readme":"# go-multiaddr\n\n[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://ipn.io)\n[![](https://img.shields.io/badge/project-multiformats-blue.svg?style=flat-square)](https://github.com/multiformats/multiformats)\n[![](https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat-square)](https://webchat.freenode.net/?channels=%23ipfs)\n[![](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)\n[![GoDoc](https://godoc.org/github.com/multiformats/go-multiaddr?status.svg)](https://godoc.org/github.com/multiformats/go-multiaddr)\n[![Travis CI](https://img.shields.io/travis/multiformats/go-multiaddr.svg?style=flat-square\u0026branch=master)](https://travis-ci.org/multiformats/go-multiaddr)\n[![codecov.io](https://img.shields.io/codecov/c/github/multiformats/go-multiaddr.svg?style=flat-square\u0026branch=master)](https://codecov.io/github/multiformats/go-multiaddr?branch=master)\n\n\u003e [multiaddr](https://github.com/multiformats/multiaddr) implementation in go\n\nMultiaddr is a standard way to represent addresses that:\n\n- Support any standard network protocols.\n- Self-describe (include protocols).\n- Have a binary packed format.\n- Have a nice string representation.\n- Encapsulate well.\n\n## Table of Contents\n\n- [Install](#install)\n- [Usage](#usage)\n  - [Example](#example)\n    - [Simple](#simple)\n    - [Protocols](#protocols)\n    - [En/decapsulate](#endecapsulate)\n    - [Tunneling](#tunneling)\n- [Maintainers](#maintainers)\n- [Contribute](#contribute)\n- [License](#license)\n\n## Install\n\n```sh\ngo get github.com/multiformats/go-multiaddr\n```\n\n## Usage\n\n### Example\n\n#### Simple\n\n```go\nimport ma \"github.com/multiformats/go-multiaddr\"\n\n// construct from a string (err signals parse failure)\nm1, err := ma.NewMultiaddr(\"/ip4/127.0.0.1/udp/1234\")\n\n// construct from bytes (err signals parse failure)\nm2, err := ma.NewMultiaddrBytes(m1.Bytes())\n\n// true\nstrings.Equal(m1.String(), \"/ip4/127.0.0.1/udp/1234\")\nstrings.Equal(m1.String(), m2.String())\nbytes.Equal(m1.Bytes(), m2.Bytes())\nm1.Equal(m2)\nm2.Equal(m1)\n```\n\n#### Protocols\n\n```go\n// get the multiaddr protocol description objects\nm1.Protocols()\n// []Protocol{\n//   Protocol{ Code: 4, Name: 'ip4', Size: 32},\n//   Protocol{ Code: 17, Name: 'udp', Size: 16},\n// }\n```\n\n#### En/decapsulate\n\n```go\nimport ma \"github.com/multiformats/go-multiaddr\"\n\nm, err := ma.NewMultiaddr(\"/ip4/127.0.0.1/udp/1234\")\n// \u003cMultiaddr /ip4/127.0.0.1/udp/1234\u003e\n\nsctpMA, err := ma.NewMultiaddr(\"/sctp/5678\")\n\nm.Encapsulate(sctpMA)\n// \u003cMultiaddr /ip4/127.0.0.1/udp/1234/sctp/5678\u003e\n\nudpMA, err := ma.NewMultiaddr(\"/udp/1234\")\n\nm.Decapsulate(udpMA) // up to + inc last occurrence of subaddr\n// \u003cMultiaddr /ip4/127.0.0.1\u003e\n```\n\n#### Tunneling\n\nMultiaddr allows expressing tunnels very nicely.\n\n```js\nprinter, _ := ma.NewMultiaddr(\"/ip4/192.168.0.13/tcp/80\")\nproxy, _ := ma.NewMultiaddr(\"/ip4/10.20.30.40/tcp/443\")\nprinterOverProxy := proxy.Encapsulate(printer)\n// /ip4/10.20.30.40/tcp/443/ip4/192.168.0.13/tcp/80\n\nproxyAgain := printerOverProxy.Decapsulate(printer)\n// /ip4/10.20.30.40/tcp/443\n```\n\n## Contribute\n\nContributions welcome. Please check out [the issues](https://github.com/multiformats/go-multiaddr/issues).\n\nCheck out our [contributing document](https://github.com/multiformats/multiformats/blob/master/contributing.md) for more information on how we work, and about contributing in general. Please be aware that all interactions related to multiformats are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).\n\nSmall note: If editing the README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.\n\n## License\n\n[MIT](LICENSE) © 2014 Juan Batiz-Benet\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultiformats%2Fgo-multiaddr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmultiformats%2Fgo-multiaddr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultiformats%2Fgo-multiaddr/lists"}