mirror of
http://galexander.org/git/simplesshd.git
synced 2024-11-13 18:58:57 +00:00
first draft of documentation
This commit is contained in:
parent
2090d565b7
commit
1485f3f838
1
doc/doit
Executable file
1
doc/doit
Executable file
@ -0,0 +1 @@
|
||||
rsync icon.png index.html shed:ga.org/software/simplesshd/
|
BIN
doc/icon.png
Normal file
BIN
doc/icon.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 20 KiB |
77
doc/index.html
Normal file
77
doc/index.html
Normal file
@ -0,0 +1,77 @@
|
||||
<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> Make a directory <tt>/sdcard/ssh</tt>, and put an
|
||||
<tt>authorized_keys</tt> file in that directory.
|
||||
<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>:
|
||||
<pre>
|
||||
Host myphone
|
||||
Port 2222
|
||||
</pre>
|
||||
<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>
|
||||
|
||||
<h3>Configuration</h3>
|
||||
|
||||
<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 come with
|
||||
busybox or whatever.</p>
|
||||
|
||||
<p>Finally 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 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>
|
||||
|
||||
<h3>Change Log</h3>
|
||||
|
||||
<ul>
|
||||
<li> <b>2014/12/22 Version 1.0:</b> Initial public release.
|
||||
</ul>
|
||||
|
||||
<h3>About</h3>
|
||||
|
||||
<p>SimpleSSHD is built using parts from open source projects: dropbear
|
||||
server, openssh (for scp and sftp-server), and rsync. Those projects in
|
||||
turn are based 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>Here is the source. If you use this, email me and I'll make sure you
|
||||
get the latest:
|
||||
<br><a href="dropbear-git-20141222.tar.bz2">a 2014/12/22 snapshot of my
|
||||
git repository</a>
|
||||
(use <tt>git clone simplesshd.git</tt>).</p>
|
||||
|
||||
</body></html>
|
Loading…
Reference in New Issue
Block a user