archive/nntpchan
Archived
1
0
Fork 0
Code
This repository has been archived on 2023-08-12. You can view files and clone it, but cannot push or open issues or pull requests.
b57778cdcf
nntpchan/doc/feeds.md

2.7 KiB
Raw Blame History

feeds.ini

Peering

In order to actually be distributed, you need another person to sync posts with, otherwise what's the point right?

Right now peering information is private, there is no link level authentication (yet) so everything is done via either a vpn tunnel or a tor hidden service.

Peering over tor

Install tor

apt-get install tor

Make a tor hidden service point from outside port 119 to port 1199 Add to /etc/tor/torrc:

HiddenServiceDir /var/lib/tor/nntp_feed
HiddenServicePort 119 127.0.0.1:1199

restart/reload tor then

cat /var/lib/tor/nntp_feed/hostname

This is your in feed address

Then to peer with someone over tor add this to you feeds.ini

[feed-ourpeer.onion]
host=PeersOnionAddress.onion
port=119
proxy-type=socks4a
proxy-host=127.0.0.1
proxy-port=9050

[ourpeer.onion]
overchan=1
ctl=1

Peering over cjdns

Set up cjdns, read more here

git clone https://github.com/cjdelisle/cjdns
cd cjdns && ./do
./cjdroute --genconf >> cjdroute.conf
./cjdroute < cjdroute.conf

Get your ipv6 address for cjdns

ip addr show tun0

Edit srnd.ini to bind nntp on that ipv6 address, make sure to use the square braces [ and ]

[nntp]
...
bind=[xxxx:xxxx:xxxx:xxx:xx....]:1199

Say you have 2 friends at fc33:3:3::aadd and fc03:9f:123::a3df.

Add to feeds.ini the following:

[feed-bob]
host=[fc33:3:3::aadd]
port=1199
proxy-type=none

[bob]
overchan=1
ctl=1

[feed-charlie]
host=[fc03:9f:123::a3df]
port=1199
proxy-type=none

[charlie]
overchan=1
ctl=1

Options

You need one connection and one settings block for each connection

Here is an example entry in feeds.ini

[feed-them.onion]
host=aabbccddeeff2233.onion
port=119
proxy-type=socks4a
proxy-host=127.0.0.1
proxy-port=9050

[them.onion]
overchan=1
ano.paste=0
ctl=1

But what does it mean?

[feed-them.onion]

Connection settings for a peer

host=aabbccddeeff2233.onion
port=119
proxy-type=socks4a
proxy-host=127.0.0.1
proxy-port=9050

Proxy settings, straight forward. Supported proxy types are socks4a and none

[them.onion]

nntp synchronization settings

overchan=1

Sync all boards, use

overchan.bad=0

to prevent certain boards from syncing with certain peers. It can be used to keep bad boards out or keep exclusive boards in

ano.paste=0

This WILL be the nntpchan pastebin, but it's not implimented yet

ctl=1

Allows you to recieve moderation notifications from other boards, it's also used for decentralized moderation