use opts.dist rather than modify req.url
update docs