{"id":19081657,"url":"https://github.com/facsimiles/miredo","last_synced_at":"2026-05-12T23:32:49.164Z","repository":{"id":256272041,"uuid":"851474999","full_name":"facsimiles/miredo","owner":"facsimiles","description":"🌐 Miredo: Seamlessly connect to IPv6 networks from IPv4 environments using Teredo tunneling. Perfect for overcoming NAT limitations, ensuring full IPv6 connectivity. Essential for developers needing reliable IPv6 access. Boost your network capabilities today! [MIRROR][UNOFFICIAL]","archived":false,"fork":false,"pushed_at":"2024-09-03T07:22:34.000Z","size":2289,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-22T06:13:54.707Z","etag":null,"topics":["bsd","ipv6","ipv6-nat","ipv6-over-udp","ipv6-relay","ipv6-support","ipv6-tunneling","linux","mirror","mirrored-repository","nat","nat-traversal","network-protocols","networking","teredo","teredo-server","tunneling","udp","unofficial","unofficial-mirror"],"latest_commit_sha":null,"homepage":"https://www.remlab.net/miredo/","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facsimiles.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog.old","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-03T06:58:06.000Z","updated_at":"2024-09-12T15:20:39.000Z","dependencies_parsed_at":"2024-09-10T00:05:33.807Z","dependency_job_id":"d3a85db9-23a5-480c-a2c2-4e7fa77dd595","html_url":"https://github.com/facsimiles/miredo","commit_stats":null,"previous_names":["facsimiles/miredo"],"tags_count":57,"template":false,"template_full_name":null,"purl":"pkg:github/facsimiles/miredo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmiredo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmiredo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmiredo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmiredo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facsimiles","download_url":"https://codeload.github.com/facsimiles/miredo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmiredo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32961782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T23:30:32.555Z","status":"ssl_error","status_checked_at":"2026-05-12T23:30:18.191Z","response_time":102,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bsd","ipv6","ipv6-nat","ipv6-over-udp","ipv6-relay","ipv6-support","ipv6-tunneling","linux","mirror","mirrored-repository","nat","nat-traversal","network-protocols","networking","teredo","teredo-server","tunneling","udp","unofficial","unofficial-mirror"],"created_at":"2024-11-09T02:38:09.262Z","updated_at":"2026-05-12T23:32:49.149Z","avatar_url":"https://github.com/facsimiles.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Miredo: open-source Teredo\n===========================\nCopyright (C) 2004-2014 Rémi Denis-Courmont.\n\n  Welcome to Miredo’s user’s guide!\n\nWhere to go?\n=============\n\n  If you’ve used olders versions of this program, you should read NEWS\nfor a summary of the most recent updates and changes.\n\n  For detailled usage instructions, you should refer to the Unix manual\npage miredo(8) which should be provided with your copy of the program.\nFor quick usage instructions, see below.\n\n  See INSTALL for general instructions on how to build the package and\ninstall the program from sources. Additionnal informations may be found\nbelow. If you are building from the Subversion repository, run the\n“./autogen.sh” script first.\n\n  This package is distributed under the terms of the General Public\nLicense (GPL) version 2 written by the Free Software Foundation, Inc.\nfor full licensing details, please read COPYING.\n\n  If you have further questions, please send an email to:\n    miredo (dash) devel (at) remlab (dot) net\n\n\nWhat is Miredo?\n================\n\n  Miredo is an Unix daemon program which mostly implements the\n“Teredo: Tunneling IPv6 over UDP through NATs” Internet proposed\nstandard (RFC 4380). It can provide either client or relay\nfunctionality. A separate program, miredo-server is also included in\nthe package; it consists of a Teredo server.\n\n  Miredo can be used to provide IPv6 connectivity to users behind NAT\ndevices, such as broadband routers. Most of these device do not support\nIPv6, and do not allow forwarding of proto-41 (including 6to4).\n\n\nSystem requirements\n====================\n\n  Miredo aims to support all POSIX.2008 operating systems with IPv6 and\nuserland layer-3 tunneling support. See below for system specific notes.\n\n  When available, Miredo can use the following optional libraries:\n - GNU gettext for localization,\n - libcap (currently Linux-specific) for POSIX capabilities,\n - Judy dynamic arrays library for better scalability.\n\nOn Linux, Miredo requires the Universal TUNTAP driver (CONFIG_TUN) and\nof course the IPv6 protocol suites (CONFIG_IPV6) support from kernel.\n\n\nQuick usage\n============\n\nEasy installation:\n-------------------\n  First, compile and install Miredo. Refer to INSTALL for detailled\ninstructions. Miredo can be installed the usual way:\n\n# ./configure\n# make\n# su\n# make install\n\n  Miredo has no particular required dependencies, besides the usual\nC compiler and development libraries.\n\n  A sample configuration file is automatically installed at\n/usr/local/etc/miredo/miredo.conf - unless the file already existed\n(which means you are probably reinstalling or upgrading Miredo). This\nsample will cause Miredo to run as a Teredo client, with\n“teredo.remlab.net” (Miredo official testing Teredo server) as its\nTeredo server. These default settings should be fine for most users.\n\nStarting the program:\n----------------------\n  Before you start, please note that Miredo must be started by root,\nand that it will detach and run in the background. If something goes\nwrong, there are two ways two know what:\n- read your system logs (typically /var/log/syslog),\n- force Miredo to run in the foreground (that’s meant for debugging),\n  by starting it with the “--foreground” command line parameter, and\n  wait for about 20 seconds.\n\n  You can now run miredo (as root!):\n# /usr/local/sbin/miredo\n\n  It will need some time to initialize, particularly if you are behind\na restricted NAT, which is frequent. After about 20 seconds, you should\nhave access to the IPv6 Internet through Teredo, with a public Teredo\nIPv6 address on the “teredo” networking interface:\n\n# ifconfig teredo\nteredo    Link encap:UNSPEC  HWaddr 00-00-00-00-00-00-00-00-00-00-00...\n          inet6 addr: 2001:0:8ac3:9ddd:0:7ffa:ad80:3464/32 Scope:...\n          inet6 addr: fe80::5445:5245:444f/64 Scope:Link\n          UP POINTOPOINT RUNNING NOARP  MTU:1280  Metric:1\n          RX packets:5 errors:0 dropped:0 overruns:0 frame:0\n          TX packets:7 errors:0 dropped:0 overruns:0 carrier:0\n          collisions:0 txqueuelen:500\n          RX bytes:468 (468.0 b)  TX bytes:560 (560.0 b)\n\n# ping6 -c 4 www.example.com\nPING www.example.com(2001:db8::dead:beef) 56 data bytes\n64 bytes from 2001:db8::dead:beef: icmp_seq=1 ttl=50 time=558 ms\n64 bytes from 2001:db8::dead:beef: icmp_seq=2 ttl=50 time=585 ms\n64 bytes from 2001:db8::dead:beef: icmp_seq=3 ttl=50 time=562 ms\n64 bytes from 2001:db8::dead:beef: icmp_seq=4 ttl=50 time=552 ms\n\n--- www.example.com ping statistics ---\n4 packets transmitted, 4 received, 0% packet loss, time 3003ms\nrtt min/avg/max/mdev = 552.830/564.865/585.031/12.218 ms\n\nMonitoring:\n------------\n  If you wish to monitor the Teredo tunnel, I suggest you use famous\nnetwork analyzer Wireshark which includes a Teredo “dissector”.\n\nTeredo relay and/or server:\n----------------------------\n  Please refer to the sample configuration miredo.conf-dist for further\ninformation. You can get a comprehensive reference of all possible\noptions in the manual pages provided with the package:\nmiredo(8) and miredo.conf(5)\n\n# man 8 miredo\n# man 5 miredo.conf\n\n\nSecuring you Miredo installation\n=================================\n\n  By default, Miredo drops its root privileges and runs as user nobody.\nWhile that is far more secure than keeping root privileges as early\nversions did, it is not optimal. Miredo should rather run with its own\nuser account rather than common user “nobody”. They are two ways to\nachieve that:\n\n- You can enable the “--enable-miredo-user” command line option when\n  running the source code configure script. If you are a packager,\n  please use that method. Miredo will try to SetUID as “miredo” by\n  default, though that can be overriden with the “-u” command line\n  option (see man page miredo(8)).\n\n- You can use the “-u” option when starting Miredo. That saves the\n  cost of recompiling Miredo. For example:\n\n  # /usr/local/sbin/miredo -u miredo\n\nNOTE: If you are running Miredo as a Teredo client, Miredo will spawn a\nseparate privileged process to configure the Teredo interface (requiring\nroot). If someone breaks Miredo, it might still be possible to break the\nIPv6 networking setup, but not compromise the whole system.\n\nPOSIX capabilities:\n--------------------\n  Miredo supports POSIX.1e capabilities (at least on Linux), if they\nare available. You should not need to worry as it is entirely\nautomatic.\n\n  If you are a packager, you should consider installing your system’s\nPOSIX capabilities library development files, before building Miredo.\n\n\nFeedback:\n==========\n\n  If you have further questions, please write to:\n\n    miredo (dash) devel (at) remlab (dot) net\n\n-- \nRémi Denis-Courmont \u003cremi (at) remlab (dot) net\u003e\nhttp://www.remlab.net/miredo/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacsimiles%2Fmiredo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacsimiles%2Fmiredo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacsimiles%2Fmiredo/lists"}