Openbsd.Gophernicus 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. version=pmwiki-2.2.130 ordered=1 urlencoded=1
  2. agent=Mozilla/5.0 (Windows NT 6.3; Win64; x64; rv:78.0) Gecko/20100101 Firefox/78.0
  3. author=mkf
  4. charset=UTF-8
  5. csum=
  6. ctime=1611819529
  7. host=198.251.81.133
  8. name=Openbsd.Gophernicus
  9. rev=12
  10. targets=
  11. text=Gopher is an application-layer protocol that provides the ability to extract and view and access various files on remote Web servers. Gopher was conceived in 1991 as one of the Internet’s first data/file access protocols to run on top of a TCP/IP network. It was developed at University of Minnesota and is named after the school's mascot.%0a%0aThere are many gopher server are available but many of them are not under development. Gophernicus is a one of the most modern, full-featured and secure gopher daemon.%0a%0a!!Installation%0a%0a[@%0a$ doas pkg_add gophernicus%0a@]%0a%0aYou need to create @@/etc/inetd.conf@@%0aAnd add the following line:%0a[@%0agopher stream tcp nowait nobody /usr/local/libexec/in.gophernicus in.gophernicus -h %3chostname>%0a@]%0a%0aChange %3chostname> to you actual hostname.%0a%0aEnable and start inetd%0a[@%0a$ doas rcctl enable inetd%0a$ doas rcctl start inetd%0a@]%0a%0aAnd you are all set.%0aPut some files under @@/var/gopher@@%0a%0aThen Fire up your gopher client pointing to your host.%0afor example:%0a[@%0alynx gopher://localhost%0a@]%0a%0a!!Configureation arguments%0a%0a!!!hostname%0aThis is by default attempted to be auto-detected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a%0a%0a!!!gopherroot%0aThe location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a%0a!!Post Install Configuration%0a%0aHere are all the options which can be use for post install configuration. you can user them only by typing %0a[@%0a$gophernicus -h example.com. %0a%0a-h hostname Change server hostname (FQDN) [$HOSTNAME]%0a%0a-p port Change server port [70]%0a%0a-T port Change TLS/SSL port [0 = disabled]%0a%0a-r root Change gopher root [/var/gopher]%0a%0a-t type Change default gopher filetype [0]%0a%0a-g mapfile Change gophermap file [gophermap]%0a%0a-a tagfile Change gophertag file [gophertag]%0a%0a-c cgidir Change CGI script directory [/cgi-bin/]%0a%0a-u userdir Change users personal gopherspace [public_gopher]%0a%0a-l logfile Log to Apache-compatible combined format logfile%0a%0a%0a-w width Change default page width [67]%0a%0a-o charset Change default output charset [UTF-8]%0a%0a%0a-s seconds Session timeout in seconds [1800]%0a%0a-i hits Maximum hits until throttling [4096]%0a%0a-k kbytes Maximum transfer until throttling [4194304]%0a%0a%0a-f filterdir Specify directory for output filters%0a%0a-e ext=type Map file extension to gopher filetype%0a%0a-R old=new Rewrite the beginning of a selector%0a%0a%0a-D text|file Set or load server description for caps.txt%0a%0a-L text|file Set or load server location for caps.txt%0a%0a-A admin Set admin email for caps.txt%0a%0a%0a-U paths Specify a colon-separated list of extra unveil(2) paths%0a%0a (OpenBSD only).%0a%0a-nv Disable virtual hosting%0a%0a-nl Disable parent directory links%0a%0a-nh Disable menu header (title)%0a%0a-nf Disable menu footer%0a%0a-nd Disable dates and filesizes in menus%0a%0a-nc Disable file content detection%0a%0a-no Disable charset conversion for output%0a%0a-nq Disable HTTP-style query strings (?query)%0a%0a-ns Disable logging to syslog%0a%0a-na Disable autogenerated caps.txt%0a%0a-nt Disable /server-status%0a%0a-nm Disable shared memory use (for debugging)%0a%0a-nr Disable root user checking (for debugging)%0a%0a-np Disable HAproxy proxy protocol%0a%0a-nx Disable execution of gophermaps and scripts%0a%0a-nu Disable personal gopherspaces%0a%0a%0a-d Debug output in syslog and /server-status%0a%0a-v Display version number and build date%0a%0a-b Display the BSD license%0a%0a-? Display this help %0a@]
  12. time=1628993186
  13. author:1628993186=mkf
  14. diff:1628993186:1628992764:=28,33c28,30%0a%3c Then Fire up your gopher client pointing to your host.%0a%3c for example:%0a%3c [@%0a%3c lynx gopher://localhost%0a%3c @]%0a%3c %0a---%0a> And fire up your gopher browser pointing to your host.%0a> lynx gopher://your-host-name%0a> %0a37,39c34,36%0a%3c This is by default attempted to be auto-detected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a%3c %0a%3c %0a---%0a> This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a> %0a> %0a46c43%0a%3c [@%0a---%0a> %0a140d136%0a%3c @]%0a\ No newline at end of file%0a
  15. host:1628993186=198.251.81.133
  16. author:1628992764=mkf
  17. diff:1628992764:1628992735:=33c33%0a%3c !!!hostname%0a---%0a> !!!hostname. %0a
  18. host:1628992764=198.251.81.133
  19. author:1628992735=mkf
  20. diff:1628992735:1628992669:=5,6c5%0a%3c !!Installation%0a%3c %0a---%0a> !!Installatio%0a31,38c30,35%0a%3c !!Configureation arguments%0a%3c %0a%3c !!!hostname. %0a%3c This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a%3c %0a%3c %0a%3c !!!gopherroot%0a%3c The location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a---%0a> !!Important configure arguments include%0a> %0a> !!!hostname. This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a> %0a> %0a> !!!gopherroot. The location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a
  21. host:1628992735=198.251.81.133
  22. author:1628992669=mkf
  23. diff:1628992669:1628304552:=5,10c5,11%0a%3c !!Installatio%0a%3c [@%0a%3c $ doas pkg_add gophernicus%0a%3c @]%0a%3c %0a%3c You need to create @@/etc/inetd.conf@@%0a---%0a> !!Installation :%0a> pkg_add -vr gophernicus%0a> %0a> You need to create the following file:%0a> %0a> vi /etc/inetd.conf%0a> %0a12c13%0a%3c [@%0a---%0a> %0a14,15c15%0a%3c @]%0a%3c %0a---%0a> %0a19,23c19,23%0a%3c [@%0a%3c $ doas rcctl enable inetd%0a%3c $ doas rcctl start inetd%0a%3c @]%0a%3c %0a---%0a> %0a> doas rcctl enable inetd%0a> %0a> doas rcctl start inetd%0a> %0a25,26c25,28%0a%3c Put some files under @@/var/gopher@@%0a%3c %0a---%0a> Put some files under%0a> %0a> /var/gopher%0a> %0a30,35c32,37%0a%3c !!Important configure arguments include%0a%3c %0a%3c !!!hostname. This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a%3c %0a%3c %0a%3c !!!gopherroot. The location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a---%0a> !!Important configure arguments include:%0a> %0a> --hostname. This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a> %0a> %0a> --gopherroot. The location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a
  24. host:1628992669=198.251.81.133
  25. author:1628304552=craziness
  26. csum:1628304552=lines accidentally combined
  27. diff:1628304552:1628304317:=21d20%0a%3c %0a
  28. host:1628304552=2601:546:8200:3710::2ba
  29. author:1628304317=craziness
  30. csum:1628304317=changed misspellings
  31. diff:1628304317:1612172947:=16c16%0a%3c Change %3chostname> to you actual hostname.%0a---%0a> Change %3chosname> to you actuall hostname.%0a
  32. host:1628304317=2601:546:8200:3710::2ba
  33. author:1612172947=wiz
  34. diff:1612172947:1612172672:=
  35. host:1612172947=2a02:c7d:75fa:4000:8f2:abef:e135:d533
  36. author:1612172672=wiz
  37. diff:1612172672:1611820918:=6,30c6,16%0a%3c pkg_add -vr gophernicus%0a%3c %0a%3c You need to create the following file:%0a%3c %0a%3c vi /etc/inetd.conf%0a%3c %0a%3c And add the following line:%0a%3c %0a%3c gopher stream tcp nowait nobody /usr/local/libexec/in.gophernicus in.gophernicus -h %3chostname>%0a%3c %0a%3c Change %3chosname> to you actuall hostname.%0a%3c %0a%3c Enable and start inetd%0a%3c %0a%3c doas rcctl enable inetd%0a%3c doas rcctl start inetd%0a%3c %0a%3c And you are all set.%0a%3c Put some files under%0a%3c %0a%3c /var/gopher%0a%3c %0a%3c And fire up your gopher browser pointing to your host.%0a%3c lynx gopher://your-host-name%0a%3c %0a---%0a> %0a> $ git clone -b 3.1.1 https://github.com/gophernicus/gophernicus.git%0a> %0a> $ cd gophernicus %0a> %0a> $ ./configure --listener=inetd%0a> %0a> $ make%0a> %0a> $ doas make install%0a> %0a32a19,21%0a> --listener. This is the only required argument. You must choose a listener that passes network requests to gophernicus, as gophernicus dosen't do this by itself. There are few other options but as we are using OPENBSD we are going to user inetd.%0a> %0a> %0a36a26,46%0a> %0a> Ao the command becomes like %0a> $ ./configure --listener=inetd --hostname=example.com --gopherroot=/var/gopher%0a> %0a> Add the following line in inetd.conf. ( /etc/inetd.conf )%0a> %0a> gopher stream tcp nowait nobody /usr/local/libexec/in.gophernicus in.gophernicus -h example.com%0a> %0a> doas rcctl enable inetd%0a> %0a> doas rcctl start inetd%0a> %0a> %0a> your gopher server is ready to server. Try to lynx gopher://example.com to access your gopher index. %0a> %0a> %0a> Please keep it in mind you cannot access gopher server with the regular browser unless you have browser extensions installed for gopher. %0a> %0a> %0a> you can find some userful information about browser extenstions here : [[https://gopher.floodgap.com/gopher/]]%0a> %0a
  38. host:1612172672=2a02:c7d:75fa:4000:8f2:abef:e135:d533
  39. author:1611820918=wiz
  40. diff:1611820918:1611819728:=15c15%0a%3c $ doas make install%0a---%0a> $ sudo make install%0a
  41. host:1611820918=77.100.11.104
  42. author:1611819728=wiz
  43. diff:1611819728:1611819585:=17,18c17,18%0a%3c !!Important configure arguments include:%0a%3c %0a---%0a> '''Important configure arguments include:%0a> '''%0a21d20%0a%3c %0a24d22%0a%3c %0a27c25%0a%3c Ao the command becomes like %0a---%0a> so the command becomes like %0a31d28%0a%3c %0a35d31%0a%3c %0a38d33%0a%3c %0a41d35%0a%3c %0a44d37%0a%3c %0a48,49c41,42%0a%3c !!Post Install Configuration%0a%3c %0a---%0a> '''Post Install Configuration'''%0a> %0a51d43%0a%3c %0a55d46%0a%3c %0a57d47%0a%3c %0a59d48%0a%3c %0a61d49%0a%3c %0a63d50%0a%3c %0a65d51%0a%3c %0a67d52%0a%3c %0a69d53%0a%3c %0a71d54%0a%3c %0a74d56%0a%3c %0a76d57%0a%3c %0a79d59%0a%3c %0a81d60%0a%3c %0a83d61%0a%3c %0a86d63%0a%3c %0a88d64%0a%3c %0a90d65%0a%3c %0a93d67%0a%3c %0a95d68%0a%3c %0a97d69%0a%3c %0a100d71%0a%3c %0a102d72%0a%3c %0a106d75%0a%3c %0a108d76%0a%3c %0a110d77%0a%3c %0a112d78%0a%3c %0a114d79%0a%3c %0a116d80%0a%3c %0a118d81%0a%3c %0a120d82%0a%3c %0a122d83%0a%3c %0a124d84%0a%3c %0a126d85%0a%3c %0a128d86%0a%3c %0a130d87%0a%3c %0a132d88%0a%3c %0a134d89%0a%3c %0a137d91%0a%3c %0a139d92%0a%3c %0a141d93%0a%3c %0a143d94%0a%3c %0a
  44. host:1611819728=77.100.11.104
  45. author:1611819585=wiz
  46. diff:1611819585:1611819529:=5,6c5,6%0a%3c !!Installation :%0a%3c %0a---%0a> '''Installation :%0a> '''%0a8d7%0a%3c %0a10d8%0a%3c %0a12d9%0a%3c %0a14d10%0a%3c %0a
  47. host:1611819585=77.100.11.104
  48. author:1611819529=wiz
  49. diff:1611819529:1611819529:=1,91d0%0a%3c Gopher is an application-layer protocol that provides the ability to extract and view and access various files on remote Web servers. Gopher was conceived in 1991 as one of the Internet’s first data/file access protocols to run on top of a TCP/IP network. It was developed at University of Minnesota and is named after the school's mascot.%0a%3c %0a%3c There are many gopher server are available but many of them are not under development. Gophernicus is a one of the most modern, full-featured and secure gopher daemon.%0a%3c %0a%3c '''Installation :%0a%3c '''%0a%3c $ git clone -b 3.1.1 https://github.com/gophernicus/gophernicus.git%0a%3c $ cd gophernicus %0a%3c $ ./configure --listener=inetd%0a%3c $ make%0a%3c $ sudo make install%0a%3c %0a%3c '''Important configure arguments include:%0a%3c '''%0a%3c --listener. This is the only required argument. You must choose a listener that passes network requests to gophernicus, as gophernicus dosen't do this by itself. There are few other options but as we are using OPENBSD we are going to user inetd.%0a%3c %0a%3c --hostname. This is by default attempted to be autodetected by the configure script, using the command hostname. It is expected to be the publicly-accessible address of the server. However, this might be completely wrong, especially on your personal machine at home or on some cheap VPS. If you know you have a fixed numerical IP, you can also directly use that. For testing, just keep the default value of localhost which will result in selectors working only when you're connecting locally.%0a%3c %0a%3c --gopherroot. The location in which your gopher server will serve from. By default is /var/gopher. Also can be changed later using the -r %3croot> parameter in configuration files.%0a%3c %0a%3c so the command becomes like %0a%3c $ ./configure --listener=inetd --hostname=example.com --gopherroot=/var/gopher%0a%3c %0a%3c Add the following line in inetd.conf. ( /etc/inetd.conf )%0a%3c gopher stream tcp nowait nobody /usr/local/libexec/in.gophernicus in.gophernicus -h example.com%0a%3c %0a%3c doas rcctl enable inetd%0a%3c doas rcctl start inetd%0a%3c %0a%3c your gopher server is ready to server. Try to lynx gopher://example.com to access your gopher index. %0a%3c %0a%3c Please keep it in mind you cannot access gopher server with the regular browser unless you have browser extensions installed for gopher. %0a%3c %0a%3c you can find some userful information about browser extenstions here : [[https://gopher.floodgap.com/gopher/]]%0a%3c %0a%3c %0a%3c '''Post Install Configuration'''%0a%3c %0a%3c Here are all the options which can be use for post install configuration. you can user them only by typing %0a%3c $gophernicus -h example.com. %0a%3c %0a%3c -h hostname Change server hostname (FQDN) [$HOSTNAME]%0a%3c -p port Change server port [70]%0a%3c -T port Change TLS/SSL port [0 = disabled]%0a%3c -r root Change gopher root [/var/gopher]%0a%3c -t type Change default gopher filetype [0]%0a%3c -g mapfile Change gophermap file [gophermap]%0a%3c -a tagfile Change gophertag file [gophertag]%0a%3c -c cgidir Change CGI script directory [/cgi-bin/]%0a%3c -u userdir Change users personal gopherspace [public_gopher]%0a%3c -l logfile Log to Apache-compatible combined format logfile%0a%3c %0a%3c -w width Change default page width [67]%0a%3c -o charset Change default output charset [UTF-8]%0a%3c %0a%3c -s seconds Session timeout in seconds [1800]%0a%3c -i hits Maximum hits until throttling [4096]%0a%3c -k kbytes Maximum transfer until throttling [4194304]%0a%3c %0a%3c -f filterdir Specify directory for output filters%0a%3c -e ext=type Map file extension to gopher filetype%0a%3c -R old=new Rewrite the beginning of a selector%0a%3c %0a%3c -D text|file Set or load server description for caps.txt%0a%3c -L text|file Set or load server location for caps.txt%0a%3c -A admin Set admin email for caps.txt%0a%3c %0a%3c -U paths Specify a colon-separated list of extra unveil(2) paths%0a%3c (OpenBSD only).%0a%3c %0a%3c -nv Disable virtual hosting%0a%3c -nl Disable parent directory links%0a%3c -nh Disable menu header (title)%0a%3c -nf Disable menu footer%0a%3c -nd Disable dates and filesizes in menus%0a%3c -nc Disable file content detection%0a%3c -no Disable charset conversion for output%0a%3c -nq Disable HTTP-style query strings (?query)%0a%3c -ns Disable logging to syslog%0a%3c -na Disable autogenerated caps.txt%0a%3c -nt Disable /server-status%0a%3c -nm Disable shared memory use (for debugging)%0a%3c -nr Disable root user checking (for debugging)%0a%3c -np Disable HAproxy proxy protocol%0a%3c -nx Disable execution of gophermaps and scripts%0a%3c -nu Disable personal gopherspaces%0a%3c %0a%3c -d Debug output in syslog and /server-status%0a%3c -v Display version number and build date%0a%3c -b Display the BSD license%0a%3c -? Display this help %0a
  50. host:1611819529=77.100.11.104