This is version 1 2 3 4 5 6 7 . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

Start a Single Tunnel#

The CrushTunnel process can be integrated into an existing workflow using a standalone machine acting as the tunnel provider, or programmatically through your own code. CrushTunnel.jar can be found in the CrushFTP WebInterface folder.

Here is a stand alone example (one long line):

java -cp CrushTunnel.jar com.crushftp.tunnel2.Tunnel2 protocol=https host=www.crushftp.com port=443 username=demo password=demo

That command would start the tunnel and make it a FTP server handling requests that ultimately ended up going through the tunnel and to the main CrushFTP server on the other side. You can control the port ranges for PASV, and the IP that is given to the FTP clients for PASV mode. The tunnel goes over HTTPS, so everything is encrypted between CrushTunnel and the server.

---

Start a Tunnel in Code#

To programmatically start the tunnel, include the CrushTunnel.jar file, and do something similar to the following:

com.crushtunnel.gui.Common.trustEverything(); //ignore SSL validation issues…bad for prod use
com.crushftp.tunnel2.Tunnel2 t = new com.crushftp.tunnel2.Tunnel2("https://www.crushftp.com:443/", "demo", "demo", false);
t.startThreads();
//tunnel is now open and ready.  Connections to it over FTP on 127.0.0.1 will be proxied securely through the tunnel to the CrushFTP FTP server side.

//to stop it later on
t.stopThisTunnel();

---

Install as a Service on Windows for an Always on Tunnel#

Here is another example for installing the tunnel as a service on Windows. First, make sure you have CrushFTP installed as a service on windows. You need this as we need the "service" folder that this creates. Copy this service folder somewhere else and call it "CrushTunnel". For my example, I put this in my program files folder.

Now edit the wrapper.conf file to make it have these contents, with adjustments to the bottom part which applies to your server.

wrapper.java.command=C:\\Program Files (x86)\\Java\\jre6\\bin\\java
wrapper.working.dir=C:\\Program Files (x86)\\CrushTunnel\\
wrapper.java.app.mainclass=com.crushtunnel.gui.GUIFrame
wrapper.console.visible=false
wrapper.console.title=CrushTunnel

wrapper.ntservice.name=CrushTunnel
wrapper.ntservice.displayname=CrushTunnel
wrapper.ntservice.description=CrushTunnel

wrapper.tray=false

wrapper.on_exit.0=SHUTDOWN
wrapper.on_exit.default=RESTART

wrapper.java.classpath.1=CrushTunnel.jar
wrapper.java.additional.1=-Xmx128m
wrapper.java.additional.2=-Dcrushtunnel.remote.protocol=https
wrapper.java.additional.3=-Dcrushtunnel.remote.ip=www.crushftp.com
wrapper.java.additional.4=-Dcrushtunnel.remote.port=443
wrapper.java.additional.5=-Dcrushtunnel.remote.user=demo
wrapper.java.additional.6=-Dcrushtunnel.remote.pass=demo

Now you can test this config from the DOS prompt, or install the service.

#test
java -jar wrapper.jar -c wrapper.conf
#install
java -jar wrapper.jar -i wrapper.conf
#remove
java -jar wrapper.jar -r wrapper.conf

(If installing the service, your DOS prompt needs to be running as an administrator.)