-whitebind behavior is not properly documented and (IMO) counterintuitive #4872

issue Michagogo opened this issue on September 8, 2014
  1. Michagogo commented at 3:25 PM on September 8, 2014: contributor

    When a -whitebind is specified in the configuration, the software does not automatically bind to 0.0.0.0 and [::]. It took me a bunch of log-examining, diffing config files, and trial-and-error to figure this out, because it seems counterintuitive and isn't mentioned in the --help output.

    At the very least, this should be mentioned in the documentation, but IMHO the way it works should be changed altogether.

    The way it was explained to me is that, if you're saying anything having to do with binding, it doesn't auto-bind anything else, and this is treated the same way as specifying -bind=whatever.

    This doesn't really make sense to me. I think of it more like the RPC interface/port/bind, as something that gives trusted software, that speaks the P2P protocol, access to the node, rather than treating it like some random untrusted peer out there. For example, you most likely don't ever want to be exposing this to the Internet. This, to me, suggests that it should be a separate system from the -bind and -listen= stuff, the way RPC is. Meaning that you can specify -whitebind=127.0.0.1:xyz without affecting the normal binding of 0.0.0.0/[::]. If you wanted to have a node that only takes whitelisted connections, the right way to do that IMO is to combine -whitebind with either -listen=0 or bind=127.0.0.1. It shouldn't be the default behavior when specifying -whitebind and no other -binds.

    Some of you may have different opinions, and I assume there'll be discussion/debate over this, but if nothing else, it should definitely be better-documented.

  2. sipa added the label Docs and Output on Sep 8, 2014
  3. sipa added the label Bug on Sep 8, 2014
  4. nopara73 commented at 10:29 PM on March 7, 2019: none

    I am searching the Internet for a while, but I don't seem to be able to figure out what whitebind does. @Michagogo would you mind to explain it?

  5. MarcoFalke commented at 1:43 PM on April 29, 2020: member

    Is this still an issue with a recent version of Bitcoin Core?

  6. MarcoFalke closed this on Apr 29, 2020

  7. MarcoFalke locked this on Feb 15, 2022

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-04-19 15:15 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me