diff --git a/README.md b/README.md index c3be7dac1..06dad640f 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,8 @@ try the **[read-only demo server](https://a.ocv.me/pub/demo/)** 👀 running fro * [searching](#searching) - search by size, date, path/name, mp3-tags, ... * [server config](#server-config) - using arguments or config files, or a mix of both * [qr-code](#qr-code) - print a qr-code [(screenshot)](https://user-images.githubusercontent.com/241032/194728533-6f00849b-c6ac-43c6-9359-83e454d11e00.png) for quick access - * [ftp-server](#ftp-server) - an FTP server can be started using `--ftp 3921` + * [ftp server](#ftp-server) - an FTP server can be started using `--ftp 3921` + * [webdav server](#webdav-server) - enable with `--dav` * [file indexing](#file-indexing) - enables dedup and music search ++ * [exclude-patterns](#exclude-patterns) - to save some time * [filesystem guards](#filesystem-guards) - avoid traversing into other filesystems @@ -696,7 +697,7 @@ print a qr-code [(screenshot)](https://user-images.githubusercontent.com/241032/ it will use your external ip (default route) unless `--qri` specifies an ip-prefix or domain -## ftp-server +## ftp server an FTP server can be started using `--ftp 3921`, and/or `--ftps` for explicit TLS (ftpes) @@ -708,6 +709,17 @@ an FTP server can be started using `--ftp 3921`, and/or `--ftps` for explicit T * some older software (filezilla on debian-stable) cannot passive-mode with TLS +## webdav server + +enable with `--dav`, supports winxp, win7 + +on windows xp/7, connect using the explorer UI: +* rightclick [my computer] -> [map network drive] -> [Connect to a network server] hyperlink -> [Choose a custom network location] -> `http://192.168.123.1:3923/` + +on windows 7/8/10, disable wpad for performance: +* control panel -> [network and internet] -> [internet options] -> [connections] tab -> [lan settings] -> automatically detect settings: Nope + + ## file indexing enables dedup and music search ++ @@ -1134,7 +1146,7 @@ some notes on hardening * `--unpost 0`, `--no-del`, `--no-mv` disables all move/delete support * `--hardlink` creates hardlinks instead of symlinks when deduplicating uploads, which is less maintenance * however note if you edit one file it will also affect the other copies - * `--vague-403` returns a "404 not found" instead of "403 forbidden" which is a common enterprise meme + * `--vague-401` returns a "404 not found" instead of "401 unauthorized" which is a common enterprise meme * `--ban-404=50,60,1440` ban client for 1440min (24h) if they hit 50 404's in 60min * **NB:** will ban anyone who enables up2k turbo * `--nih` removes the server hostname from directory listings diff --git a/copyparty/__main__.py b/copyparty/__main__.py index 18c0a98e8..58498f0bc 100755 --- a/copyparty/__main__.py +++ b/copyparty/__main__.py @@ -631,6 +631,10 @@ def run_argparse(argv: list[str], formatter: Any, retry: bool) -> argparse.Names ap2.add_argument("--ftp-nat", metavar="ADDR", type=u, help="the NAT address to use for passive connections") ap2.add_argument("--ftp-pr", metavar="P-P", type=u, help="the range of TCP ports to use for passive connections, for example \033[32m12000-13000") + ap2 = ap.add_argument_group('WebDAV options') + ap2.add_argument("--dav", action="store_true", help="enable webdav") + ap2.add_argument("--dav-nr", action="store_true", help="reject depth:infinite requests (recursive file listing); breaks spec compliance and some clients, which might be a good thing since depth:infinite is extremely server-heavy") + ap2 = ap.add_argument_group('opt-outs') ap2.add_argument("-nw", action="store_true", help="never write anything to disk (debug/benchmark)") ap2.add_argument("--keep-qem", action="store_true", help="do not disable quick-edit-mode on windows (it is disabled to avoid accidental text selection which will deadlock copyparty)") diff --git a/copyparty/authsrv.py b/copyparty/authsrv.py index 6ba44390f..daaf6b484 100644 --- a/copyparty/authsrv.py +++ b/copyparty/authsrv.py @@ -577,12 +577,19 @@ class VFS(object): yield x def zipgen( - self, vrem: str, flt: set[str], uname: str, dots: bool, scandir: bool + self, + vrem: str, + flt: set[str], + uname: str, + dots: bool, + dirs: bool, + scandir: bool, + wrap: bool = True, ) -> Generator[dict[str, Any], None, None]: # if multiselect: add all items to archive root # if single folder: the folder itself is the top-level item - folder = "" if flt else (vrem.split("/")[-1] or "top") + folder = "" if flt or not wrap else (vrem.split("/")[-1] or "top") g = self.walk(folder, vrem, [], uname, [[True]], dots, scandir, False) for _, _, vpath, apath, files, rd, vd in g: @@ -618,6 +625,21 @@ class VFS(object): for f in [{"vp": v, "ap": a, "st": n[1]} for v, a, n in ret]: yield f + if not dirs: + continue + + ts = int(time.time()) + st = os.stat_result((16877, -1, -1, 1, 1000, 1000, 8, ts, ts, ts)) + dnames = [n[0] for n in rd] + dstats = [n[1] for n in rd] + dnames += list(vd.keys()) + dstats += [st] * len(vd) + vpaths = [vpath + "/" + n for n in dnames] if vpath else dnames + apaths = [os.path.join(apath, n) for n in dnames] + ret2 = list(zip(vpaths, apaths, dstats)) + for d in [{"vp": v, "ap": a, "st": n} for v, a, n in ret2]: + yield d + if WINDOWS: re_vol = re.compile(r"^([a-zA-Z]:[\\/][^:]*|[^:]*):([^:]*):(.*)$") diff --git a/copyparty/httpcli.py b/copyparty/httpcli.py index 1196f13e5..498afa83e 100644 --- a/copyparty/httpcli.py +++ b/copyparty/httpcli.py @@ -6,6 +6,7 @@ import base64 import calendar import copy import gzip +import itertools import json import os import re @@ -237,7 +238,8 @@ class HttpCli(object): self.http_ver = "HTTP/1.1" # self.log("pebkac at httpcli.run #1: " + repr(ex)) self.keepalive = False - self.loud_reply(unicode(ex), status=ex.code, volsan=True) + h = {"WWW-Authenticate": "Basic"} if ex.code == 401 else {} + self.loud_reply(unicode(ex), status=ex.code, headers=h, volsan=True) return self.keepalive if self.args.rsp_slp: @@ -357,8 +359,8 @@ class HttpCli(object): except: pass - pwd = uparam.get("pw") or pwd - self.uname = self.asrv.iacct.get(pwd) or "*" + self.pw = uparam.get("pw") or pwd + self.uname = self.asrv.iacct.get(self.pw) or "*" self.rvol = self.asrv.vfs.aread[self.uname] self.wvol = self.asrv.vfs.awrite[self.uname] self.mvol = self.asrv.vfs.amove[self.uname] @@ -366,8 +368,8 @@ class HttpCli(object): self.gvol = self.asrv.vfs.aget[self.uname] self.upvol = self.asrv.vfs.apget[self.uname] - if pwd: - self.out_headerlist.append(("Set-Cookie", self.get_pwd_cookie(pwd)[0])) + if self.pw: + self.out_headerlist.append(("Set-Cookie", self.get_pwd_cookie(self.pw)[0])) if self.is_rclone: uparam["raw"] = "" @@ -396,6 +398,8 @@ class HttpCli(object): return self.handle_put() and self.keepalive elif self.mode == "OPTIONS": return self.handle_options() and self.keepalive + elif self.mode == "PROPFIND": + return self.handle_propfind() and self.keepalive else: raise Pebkac(400, 'invalid HTTP mode "{0}"'.format(self.mode)) @@ -425,8 +429,9 @@ class HttpCli(object): self.conn.hsrv.broker.say("log_stacks") msg += "hint: important info in the server log\r\n" - msg = "
" + html_escape(msg)
- self.reply(msg.encode("utf-8", "replace"), status=pex.code, volsan=True)
+ zb = b"" + html_escape(msg).encode("utf-8", "replace")
+ h = {"WWW-Authenticate": "Basic"} if pex.code == 401 else {}
+ self.reply(zb, status=pex.code, headers=h, volsan=True)
return self.keepalive
except Pebkac:
return False
@@ -467,6 +472,7 @@ class HttpCli(object):
# close if unknown length, otherwise take client's preference
response.append("Connection: " + ("Keep-Alive" if self.keepalive else "Close"))
+ response.append("Date: " + datetime.utcnow().strftime(HTTP_TS_FMT))
# headers{} overrides anything set previously
if headers:
@@ -658,19 +664,205 @@ class HttpCli(object):
return self.tx_browser()
+ def handle_propfind(self) -> bool:
+ if not self.args.dav:
+ raise Pebkac(405, "WebDAV is disabled in server config")
+
+ if not self.can_read and not self.can_write and not self.can_get:
+ if self.vpath:
+ self.log("inaccessible: [{}]".format(self.vpath))
+ return self.tx_404(True)
+
+ self.uparam["h"] = ""
+
+ enc = "windows-31j"
+ enc = "shift_jis"
+ enc = "utf-8"
+ uenc = enc.upper()
+
+ clen = int(self.headers.get("content-length", 0))
+ if clen:
+ buf = b""
+ for rbuf in self.get_body_reader()[0]:
+ buf += rbuf
+ if not rbuf or len(buf) >= 32768:
+ break
+
+ props_lst: list[str] = []
+ props_xml = buf.decode(enc, "replace")
+ # dont want defusedxml just for this
+ ptn = re.compile("<(?:[^ :]+:)?([^ =/>]+)")
+ in_prop = False
+ for ln in props_xml.replace(">", "\n").split("\n"):
+ m = ptn.search(ln)
+ if not m:
+ continue
+
+ tag = m.group(1).lower()
+ if tag == "prop":
+ in_prop = not in_prop
+ continue
+
+ if not in_prop:
+ continue
+
+ props_lst.append(tag)
+ else:
+ props_lst = [
+ "contentclass",
+ "creationdate",
+ "defaultdocument",
+ "displayname",
+ "getcontentlanguage",
+ "getcontentlength",
+ "getcontenttype",
+ "getlastmodified",
+ "href",
+ "iscollection",
+ "ishidden",
+ "isreadonly",
+ "isroot",
+ "isstructureddocument",
+ "lastaccessed",
+ "name",
+ "parentname",
+ "resourcetype",
+ "supportedlock",
+ ]
+
+ props = set(props_lst)
+ vn, rem = self.asrv.vfs.get(self.vpath, self.uname, True, False)
+ depth = self.headers.get("depth", "infinity").lower()
+
+ if depth == "infinity":
+ if self.args.dav_nr:
+ raise Pebkac(412, "recursive file listing is disabled in server config")
+
+ fgen = vn.zipgen(
+ rem,
+ set(),
+ self.uname,
+ self.args.ed,
+ True,
+ not self.args.no_scandir,
+ wrap=False,
+ )
+
+ elif depth == "1":
+ _, vfs_ls, vfs_virt = vn.ls(
+ rem, self.uname, not self.args.no_scandir, [[True]]
+ )
+ zi = int(time.time())
+ zsr = os.stat_result((16877, -1, -1, 1, 1000, 1000, 8, zi, zi, zi))
+ ls = [{"vp": vp, "st": st} for vp, st in vfs_ls]
+ ls += [{"vp": v, "st": zsr} for v in vfs_virt]
+ fgen = ls # type: ignore
+
+ elif depth == "0":
+ fgen = [] # type: ignore
+
+ else:
+ t = "invalid depth value '{}' (must be either '0' or '1'{})"
+ t2 = "" if self.args.dav_nr else " or 'infinity'"
+ raise Pebkac(412, t.format(depth, t2))
+
+ topdir = {"vp": "", "st": os.stat(vn.canonical(rem))}
+ fgen = itertools.chain([topdir], fgen) # type: ignore
+ vtop = vjoin(vn.vpath, rem)
+
+ self.send_headers(
+ None, 207, "text/xml; charset=" + enc, {"Transfer-Encoding": "chunked"}
+ )
+
+ ret = '\n'
+ ret = ret.format(uenc)
+ for x in fgen:
+ vp = x["vp"]
+ st: os.stat_result = x["st"]
+ rp = vjoin(vtop, vp)
+ isdir = stat.S_ISDIR(st.st_mode)
+
+ t = "/{}{} "
+ ret += t.format(html_escape(rp), "/" if isdir and vp else "")
+
+ pvs: dict[str, str] = {
+ "displayname": html_escape(vp.split("/")[-1]),
+ "getlastmodified": datetime.utcfromtimestamp(st.st_mtime).strftime(
+ HTTP_TS_FMT
+ ),
+ "resourcetype": ' ' if isdir else "",
+ "supportedlock": ' ',
+ }
+ if not isdir:
+ pvs["getcontenttype"] = "application/octet-stream"
+ pvs["getcontentlength"] = str(st.st_size)
+
+ for k, v in pvs.items():
+ if k not in props:
+ continue
+ elif v:
+ ret += "{1} ".format(k, v)
+ else:
+ ret += " ".format(k)
+
+ ret += " HTTP/1.1 200 OK "
+
+ missing = [" ".format(x) for x in props if x not in pvs]
+ if missing and clen:
+ t = "{} HTTP/1.1 404 Not Found "
+ ret += t.format("".join(missing))
+
+ ret += " "
+ while len(ret) >= 0x800:
+ ret = self.send_chunk(ret, enc, 0x800)
+
+ ret += " "
+ while ret:
+ ret = self.send_chunk(ret, enc, 0x800)
+
+ self.send_chunk("", enc, 0x800)
+ return True
+
+ def send_chunk(self, txt: str, enc: str, bmax: int):
+ orig_len = len(txt)
+ buf = txt[:bmax].encode(enc, "replace")[:bmax]
+ try:
+ _ = buf.decode(enc)
+ except UnicodeDecodeError as ude:
+ buf = buf[: ude.start]
+
+ txt = txt[len(buf.decode(enc)) :]
+ if txt and len(txt) == orig_len:
+ raise Pebkac(500, "chunk slicing failed")
+
+ buf = "{:x}\r\n".format(len(buf)).encode(enc) + buf
+ self.s.sendall(buf + b"\r\n")
+ return txt
+
def handle_options(self) -> bool:
if self.do_log:
self.log("OPTIONS " + self.req)
- self.send_headers(
- None,
- 204,
- headers={
- "Access-Control-Allow-Origin": "*",
- "Access-Control-Allow-Methods": "*",
- "Access-Control-Allow-Headers": "*",
- },
- )
+ ret = {
+ "Allow": "GET, HEAD, POST, PUT, OPTIONS",
+ "Access-Control-Allow-Origin": "*",
+ "Access-Control-Allow-Methods": "*",
+ "Access-Control-Allow-Headers": "*",
+ }
+
+ wd = {
+ "Dav": "1, 2",
+ "Ms-Author-Via": "DAV",
+ }
+
+ if self.args.dav:
+ # PROPPATCH, LOCK, UNLOCK, COPY: noop (spec-must)
+ zs = ", PROPFIND, PROPPATCH, LOCK, UNLOCK, MKCOL, COPY, MOVE, DELETE"
+ ret["Allow"] += zs
+ ret.update(wd)
+
+ # winxp-webdav doesnt know what 204 is
+ self.send_headers(0, 200, headers=ret)
return True
def handle_put(self) -> bool:
@@ -1977,7 +2169,9 @@ class HttpCli(object):
self.log(cdis)
self.send_headers(None, mime=mime, headers={"Content-Disposition": cdis})
- fgen = vn.zipgen(rem, set(items), self.uname, dots, not self.args.no_scandir)
+ fgen = vn.zipgen(
+ rem, set(items), self.uname, False, dots, not self.args.no_scandir
+ )
# for f in fgen: print(repr({k: f[k] for k in ["vp", "ap"]}))
bgen = packer(self.log, fgen, utf8="utf" in uarg, pre_crc="crc" in uarg)
bsent = 0
@@ -2023,7 +2217,7 @@ class HttpCli(object):
mime, ico = self.ico.get(ext, not exact, chrome)
dt = datetime.utcfromtimestamp(self.E.t0)
- lm = dt.strftime("%a, %d %b %Y %H:%M:%S GMT")
+ lm = dt.strftime(HTTP_TS_FMT)
self.reply(ico, mime=mime, headers={"Last-Modified": lm})
return True
diff --git a/copyparty/httpconn.py b/copyparty/httpconn.py
index b1e029fb0..9c9b0c22c 100644
--- a/copyparty/httpconn.py
+++ b/copyparty/httpconn.py
@@ -34,6 +34,9 @@ if TYPE_CHECKING:
from .httpsrv import HttpSrv
+PTN_HTTP = re.compile(br"[A-Z]{3}[A-Z ]")
+
+
class HttpConn(object):
"""
spawned by HttpSrv to handle an incoming client connection,
@@ -134,7 +137,7 @@ class HttpConn(object):
self.s.send(b"HTTP/1.1 400 Bad Request\r\n\r\n" + err.encode("utf-8"))
return False
- return method not in [None, b"GET ", b"HEAD", b"POST", b"PUT ", b"OPTI"]
+ return not method or not bool(PTN_HTTP.match(method))
def run(self) -> None:
self.sr = None
diff --git a/copyparty/util.py b/copyparty/util.py
index 574949ff0..d731dbcc7 100644
--- a/copyparty/util.py
+++ b/copyparty/util.py
@@ -130,13 +130,16 @@ HTTPCODE = {
200: "OK",
204: "No Content",
206: "Partial Content",
+ 207: "Multi-Status",
302: "Found",
304: "Not Modified",
400: "Bad Request",
+ 401: "Unauthorized",
403: "Forbidden",
404: "Not Found",
405: "Method Not Allowed",
411: "Length Required",
+ 412: "Precondition Failed",
413: "Payload Too Large",
416: "Requested Range Not Satisfiable",
422: "Unprocessable Entity",
@@ -1356,7 +1359,7 @@ def gencookie(k: str, v: str, dur: Optional[int]) -> str:
v = v.replace(";", "")
if dur:
dt = datetime.utcfromtimestamp(time.time() + dur)
- exp = dt.strftime("%a, %d %b %Y %H:%M:%S GMT")
+ exp = dt.strftime(HTTP_TS_FMT)
else:
exp = "Fri, 15 Aug 1997 01:00:00 GMT"
@@ -1564,7 +1567,10 @@ def vsplit(vpath: str) -> tuple[str, str]:
def vjoin(rd: str, fn: str) -> str:
- return rd + "/" + fn if rd else fn
+ if rd and fn:
+ return rd + "/" + fn
+ else:
+ return rd or fn
def w8dec(txt: bytes) -> str: