mirror of
http://galexander.org/git/simplesshd.git
synced 2024-11-27 09:48:08 +00:00
108 lines
4.3 KiB
HTML
108 lines
4.3 KiB
HTML
<html><head><title>SimpleSSHD</title></head>
|
|
<body>
|
|
<p style="float:right;"><img src="icon.png"></p>
|
|
<h1>SimpleSSHD</h1>
|
|
|
|
<p>SimpleSSHD is an SSH2 server based on dropbear that supports scp,
|
|
sftp, and rsync. It only supports public-key based authentication (no
|
|
password/interactive auth). It does not use root, which means it must
|
|
listen on a port over 1024 (defaults to port 2222).</p>
|
|
|
|
<h2>Quick start</h2>
|
|
|
|
<ul>
|
|
<li> Install SimpleSSHD.
|
|
<li> Either:
|
|
<ul>
|
|
<li> Go to SimpleSSHD -> Menu (upper right) -> Authorized Keys, and
|
|
either cut and paste an SSH public key or "Fetch" one via HTTP.
|
|
<li> OR: Make a directory <tt>/sdcard/ssh</tt>, and put an
|
|
<tt>authorized_keys</tt> file in that directory.
|
|
</ul>
|
|
<li> On any computer which will connect to your Android device, set the
|
|
port to 2222. With OpenSSH, this can be done by putting these lines in
|
|
<tt>~/.ssh/config</tt>:
|
|
<blockquote><pre>
|
|
Host myphone
|
|
Port 2222
|
|
</pre></blockquote>
|
|
<li> Launch SimpleSSHD, and in Settings enable "Start on Boot", and
|
|
manually start it for the first time.
|
|
<li> You might want to put a <tt>.profile</tt> in <tt>/sdcard/ssh</tt>,
|
|
too.
|
|
</ul>
|
|
|
|
<p>Voila! You can use ssh/scp/sftp/rsync to talk to your Android device!</p>
|
|
|
|
<h2>Configuration</h2>
|
|
|
|
<p>There are three directory settings that are important for SimpleSSHD.</p>
|
|
|
|
<p>The first is the path for general dropbear files, which defaults to
|
|
<tt>/sdcard/ssh</tt>. Most importantly, this is where
|
|
<tt>authorized_keys</tt> is found. It is also where host keys wind up
|
|
(they are created on demand), and where temporary files go.</p>
|
|
|
|
<p>Next is the path to the login shell. The default Android shell is
|
|
<tt>/system/bin/sh</tt>, but you may prefer to use the one that comes with
|
|
busybox or whatever. If you set it to the su binary (i.e.,
|
|
<tt>/system/xbin/su</tt>), then scp, sftp, and
|
|
rsync will run as root and should be able to access files
|
|
outside of the sdcard.</p>
|
|
|
|
<p>A bug in SuperSU interacts with an infelicity in rsync to cause an
|
|
occasional deadlock. This is a real pain because I use SuperSU+rsync
|
|
for system-wide backups, which will always eventually trigger the
|
|
deadlock. To work around this, there is a "Buffer hack" option that
|
|
should be enabled if you use rsync with SuperSU. It adds a miniscule
|
|
overhead to rsync, but isn't harmful even if you aren't using
|
|
SuperSU.</p>
|
|
|
|
<p>Finally, there is the path for the home directory, which also defaults
|
|
to <tt>/sdcard/ssh</tt>. This is where your ssh session starts out, and is
|
|
where <tt>.profile</tt> will be found if it is present.</p>
|
|
|
|
<p>There is also a place where you can put additional commandline options
|
|
for dropbear server. The options which are hardcoded are:
|
|
<tt>-R -F -p :portno</tt>.
|
|
You can use <tt>\</tt> or <tt>"</tt> to escape characters in this
|
|
commandline.</p>
|
|
|
|
<h2>Change Log</h2>
|
|
|
|
<ul>
|
|
<li> <b>2014/12/22 Version 1.0:</b> Initial public release.
|
|
<li> <b>2014/12/29 Version 1.1:</b> Works with Lollipop now.
|
|
<li> <b>2015/01/18 Version 1.2:</b> Displays the IP address it's listening on.
|
|
<li> <b>2015/06/21 Version 1.3:</b> Hack to make rsync work with SuperSU.
|
|
<li> <b>2015/11/23 Version 1.4:</b> Don't abort if IP address lookup fails, and make proper "About" menu.
|
|
<li> <b>2016/06/11 Version 1.5:</b> SuperSU+rsync hack now limits the
|
|
buffer size to 1MB.
|
|
<li> <b>2016/06/12 Version 1.6:</b> Fix typo that broke scp/sftp/rsync in
|
|
version 1.5.
|
|
<li> <b>2016/06/19 Version 1.7:</b> Don't clear environment variables (so
|
|
you can use <tt>am</tt> or <tt>pm</tt> more easily). Add "Authorized
|
|
Keys" menu option to help maintain the <tt>authorized_keys</tt> file.
|
|
<li> <b>2016/06/21 Version 1.8:</b> sftp, rsync, and scp now work on
|
|
files bigger than 2GB.
|
|
<li> <b>2016/07/04 Version 1.9:</b> Restart sshd if the system kills it.
|
|
</ul>
|
|
|
|
<h2>About</h2>
|
|
|
|
<p>SimpleSSHD is built using parts from open source projects:
|
|
<a href="https://matt.ucc.asn.au/dropbear/dropbear.html">Dropbear SSH</a>,
|
|
<a href="http://www.openssh.com/">openssh</a> (for scp and sftp-server),
|
|
and <a href="http://rsync.samba.org/">rsync</a>. Those projects in turn
|
|
are built on other projects. A lot of people's work is represented here,
|
|
and very little of my own.</p>
|
|
|
|
<p>But if you find bugs/infelicities, it's probably my fault, so email
|
|
me:<br>
|
|
<img src="/email.png"></p>
|
|
|
|
<p>To get the source:<br>
|
|
<blockquote><pre>git clone http://galexander.org/git/simplesshd.git</pre></blockquote></p>
|
|
|
|
</body></html>
|