» HOW TO: Install a BNC
» HOW TO: Install a BNC
| 1. Introduction | |||||||||
| A BNC or IRC Bouncer, acts as a proxy for irc, allowing you to hide your real IP address and use a vhost. Connecting to IRC via your shell account using a BNC will benefit you in many ways, such as:-Anonymity: Because the BNC is routing you through the shell server, your IP stays private. Your real IP address will not show up on IRC, therefore your IP address cannot be traced directly back to you. -Protection: Because of the fact that a BNC hides your IP address, you should be pretty immune to attacks that can be launched against you. -Vhosts: Vhosts or Virtual Hosts are used in conjunction with a BNC. The BNC will allow you to switch hostname at leisure, with practically no limits on what you can use. |
|||||||||
| 2. Installation | |||||||||
| There are two different ways to install a BNC.If you want a fast install and to get the job done quick use method a) below. If you know your way around the unix operating system, and have a specific reason use method b) |
|||||||||
| a) Pre-Compiled | |||||||||
| After logging into your account type: getbnc This will launch the install of the BNC. Select OK once the install is complete, the automated install will also launch the configuration script, skip to section 3-b Automated Configuration for details on how to answer the questions. | |||||||||
| b) New Install | |||||||||
| First you will need to login to the shell account. Then you will have to download the BNC source to your account. bash$ wget http://gotbnc.com/files/bnc2.9.4.tar.gz => `bnc2.9.4.tar.gz’ Resolving gotbnc.com… done. Connecting to gotbnc.com[208.155.109.110]:80… connected. HTTP request sent, awaiting response… 200 OK Length: 52,569 [application/x-tar]100%[====================================>] 52,569 116.41K/s ETA 00:0021:54:57 (116.41 KB/s) – `bnc2.9.4.tar.gz’ saved bash-2.05b$ Now that you have downloaded the source to your account you have to uncompress the archive:- bash$ tar -zxvf bnc2.9.4.tar.gz We need to go into the bnc directory:- bash$ cd bnc2.9.4
We will now launch the BNC configuration:- bash$ ./configure Finally the compile the BNC:- bash$ gmake You are done! The BNC is installed, skip to Paragraph 3-a Manual Configuration. |
|||||||||
| 3. Configuration | |||||||||
| a) Manual | |||||||||
| The BNC configuration file looks like this:You will need to remove the # in front of every line you wish to use.Make sure you are in the bnc directory using “pwd” if you are not navigate to the directory using “ls” and “cd”. Open up example.conf with your favorite text editor, in the screenshot above we used “pico”.Edit your file as follows:S:+password Replace password with the password you wish to use. The + in front of it will make an encrypted password and makes for better security, but if you do not wish to encrypt, then just remove the +. D:port:1:+password Replace port with any number between 10000 and 55000, this is the port you will use to connect to the BNC. Make sure to use a number between the range given to you, otherwise the BNC will NOT start. Replace password with a password of your choice (same as supervisor is fine).The optional configurations are self explanatory, if you wish to use them just remove the # in front of the line in question.Save the file to bnc.conf and you are done. |
|||||||||
| b) Automated | |||||||||
| If you are not continuing from 2-b Installation then type:-bash-2.05b$ ./bncsetupOtherwise just answer the questions:-Port to listen on? Anything between 10000 and 55000 is fine. -Pick a Password. -Use Encrypted passes in config file? Highly recommend you enter “yes” -Enter a default Vhost to use? Yes or No If you choose yes, you can find a list of public vhosts on the shell by typing “vhosts” at the shell prompt. -Would you like BNC to log? If you choose yes you will be asked to specify a filename for the BNC to log to. -Would you like BNC to display a MOTD? MOTD means message of the day. This message will be displayed everytime you connect to the BNC. If you answer yes, you will be asked to specify the filename of the motd. -Pick a File to save configuration in if you do not want to use the default.Once you are done the script will exit out and you will be ready to start using the BNC. |
|||||||||
| 4. Starting the BNC. | |||||||||
| To start the daemon you need to be in the bnc directory:-bash-2.05b$ pwd /home/username/bncx.x.xIf you are not in the bnc directory, navigate to it using “cd”To start the BNC type:./bncThis will work if your configuration file is called bnc.conf, if you named the configuration something different you will need to type: ./bnc file.conf -bash-2.05b$ ./bnc |
|||||||||
| 5. Stopping the BNC. | |||||||||
| You will need to check your current jobs. Type: ps –x
OR ps –U username bash$ ps -x |
|||||||||
Common Errors:
|
|||||||||
| 6. Connecting to the BNC | |||||||||
| Open up your favorite IRC client IRSSI, mIRC, jIRC, BitchX, Xchat etc…Use the following commands to connect to the BNC.
/server absinthe.freebsdshell.com <PORT>
Common Problems:
|
|||||||||
| 7. Getting more help | |||||||||
| If this Tutorial is not enough for you, just email support@freebsdshell.com with the following information: Login Name Detailed description of the problem Screenshot, or copy paste of the error. If you want live help, indicate the IRC network on which are on, you IRC nickname and channel and what times you are available between. |
|||||||||
| 8. Relevant Links | |||||||||
| BNC Home Page | |||||||||