What & How & Why

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

other:start [2022/06/24 11:12] – 创建 codinghareother:start [2022/06/24 11:12] (当前版本) – 移除 codinghare
行 1: 行 1:
-======常见运维问题===== 
-一些个人网站环境配置及常见问题记录。 
----- 
- 
-====AMH==== 
-References:  
-  * [[https://amh.sh|AMH官方网站]] 
-===AMH 查看默认密码=== 
-使用以下命令则可以查看: 
-<code bash> 
-cat /root/amh.log 
-</code> 
- 
-===MySQL无法自动启动=== 
- 
-MYSQL 在重启服务器时不能启动,尝试以下方法: 
-\\ 
-\\ 
-删除 ''my.inf'' 
- 
-<code bash> 
-cd /etc/ 
-rm my.inf 
-</code> 
- 
-===SSL 配置=== 
-==SSL多虚拟主机== 
-单IP的多个虚拟主机只需要一个 SSL证书即可。配置步骤: 
-  - 在 ''amh.sh/ssl.htm'' 上申请证书,申请的时候将所有虚拟主机的域名输入。 
-  - 将得到的证书在 ''amhssl'' 中添加。 
-  - 制定自动更新的策略。 
-====Dokuwiki==== 
-Rreferences: 
-  * [[https://www.nginx.com/resources/wiki/start/topics/recipes/dokuwiki/|Nginx Official guide for Dokuwiki]] 
- 
-===Dokuwiki Nginx Rewrite 规则=== 
- 
-将下列规则添加到 AMH 的 ''rewrite'' 模块中: 
- 
-<code nginx> 
-location / { 
-    index doku.php; 
-    try_files $uri $uri/ @dokuwiki; 
-} 
- 
-#caching: warning: will cause picture 404 problem if your wiki is running in rewrite mode 1. 
-  location ~ ^/lib.*\.(gif|png|ico|jpg)$ { 
-    expires 30d; 
-} 
- 
-#dir safety 
-location ^~ /conf/ { return 403; } 
-location ^~ /data/ { return 403; } 
- 
-#rewrite 
-Location @dokuwiki { 
-        # rewrites "doku.php/" out of the URLs if you set the userewrite setting to .htaccess in dokuwiki config page 
-        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last; 
-        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last; 
-        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last; 
-        rewrite ^/(.*) /doku.php?id=$1&$args last; 
-    } 
-</code> 
-==Dokuwiki 重写后图片显示不正常(Nginx&AMH)== 
-Dokuwiki URL Rewrite 与以下代码冲突: 
-<code nginx> 
-location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|mp3|wma)$ { 
-    expires      30d; 
-} 
-</code> 
-而 AMH 的 ''nginx.conf'' 需要到所建立的环境下的 ''vhost'' 目录下找对应虚拟主机的文件(一般是以 ''域名.conf'' 格式的 ''conf'' 文件)。找到以后然后将里面的该段代码注释掉。如果用了 Https, 则同时需要注释掉 HTTPS 版本的 ''conf'' 文件。 
- 
-===Dokuwiki Nginx 安全规则=== 
- 
-该段代码用于防止除 ''conf'' 和 ''data'' 以外的重要文件本下载。 
-\\ 
-使用:添加以下代码到 ''rewrite'' 模块中: 
-<code nginx> 
-# Block access to data folders 
-location ~ /(data|conf|bin|inc)/ { 
-    deny all; 
-} 
-# Block access to .htaccess files 
-location ~ /\.ht { 
-    deny all; 
-} 
-</code> 
- 
-===Dokuwiki 使用=== 
- 
-  * 插件的安装:直接到后台的插件管理器中寻找指定的插件下载安装即可。 
- 
-==常用插件== 
- 
-  * Add New Page:可以直接在没有创建页面的位置直接创建页面,非常方便。 
-  * Code Prettifier:非常好用的代码高亮。 
-  * Edittable :图形化界面的表格创建,比较方便,但有自适应问题。 
-  * Fastwiki :优化 Dokuwiki 的访问速度(预加载)。 
-  * Google Document Viewer :可以直接在 Dokuwiki 中查看 Google 文档。 
-  * MathJax :数学公式插件。 
-  * Pure SVG Insert:使 Dokuwiki 支持 SVG 的显示。 
-  * DokuWiki Upgrade:一键升级 Dokuwiki,必备插件。 
-  * Wrap:很好用的内容排版插件。 
-===Dokuwiki 相关问题=== 
-==Dokuwiki 上传附件显示 "Failed"== 
-解决方法:进入服务器的 ''php.ini'' 配置文件,添加或修改以下设置: 
-<code php> 
-always_populate_raw_post_data = -1 
-</code> 
-====服务器通用前端优化==== 
- 
-===Leverage browser caching=== 
- 
-<del>如果使用 Nginx 对 **Dokuwiki** 进行 Leverage browser caching,会导致被缓存的图片无法在媒体管理器以及正文中显示。该问题出现在从 Apache 迁移到 Nginx 的过程中,怀疑是 Nginx 本身对 Dokuwiki 的支持不佳。</del> 
- 
-<del>**解决方法(过时)**:由于 AMH 的 ''Nginx.conf'' 自带 caching,需要手动去 ''/yourwebdir/vhost/yourweb.conf'' 将如下的缓存规则删除。</del> 
- 
-<WRAP  round tip 60%> 
-解决方法:使用新版本的重写规则,请参见前面。 
-</WRAP> 
- 
- 
-\\ 
-\\ 
-**Nginx** 版本的通用优化代码如下: 
-<code nginx> 
-location ~*  \.(jpg|jpeg|png|gif|ico|css|js)$ { 
-    expires 365d; 
-} 
- 
-location ~*  \.(pdf)$ { 
-    expires 30d; 
-} 
-</code> 
- 
-====Typecho==== 
- 
-一些 Typecho 的改造 / 使用 问题收集。 
-===后台 Access Denied=== 
- 
-在 AMH 中开启 ''pathinfo'' 插件的支持即可。 
- 
-===Typecho 改造指南=== 
- 
-==评论:添加额外样式给管理员== 
-Typecho 可以针对当前用户是否是管理员来添加额外的样式。一个简单的应用例子如下: 
-\\ 
-\\ 
-首先我们需要官方帮助文档中的自定义函数。该函数用于判断当前评论用户是否为管理员,通过 ''AuthorId'' 和 ''ownerid'' 是否相等来判断: 
-<code php> 
-<?php function threadedComments($comments, $options) { 
-    $commentClass = ''; 
-    if ($comments->authorId) { 
-        if ($comments->authorId == $comments->ownerId) { 
-            $commentClass .= ' comment-by-author';  //如果是文章作者的评论添加 .comment-by-author 样式 
-        } else { 
-            $commentClass .= ' comment-by-user';  //如果是评论作者的添加 .comment-by-user 样式 
-        } 
-    }  
-    $commentLevelClass = $comments->_levels > 0 ? ' comment-child' : ' comment-parent';  //评论层数大于0为子级,否则是父级 
-?> 
-/* 自定义评论的代码结构 */ 
-<?php } ?> 
-</code> 
-\\ 
-接下来会通过一段函数将增加的样式表打印出来,结果是 ''comment-by-author'' 或者 ''comment-by-user'' 
-<code php> 
-<li id="li-<?php $comments->theId(); ?>" class="comment-body<?php  
-if ($comments->levels > 0) { 
-    echo ' comment-child'; 
-    $comments->levelsAlt(' comment-level-odd', ' comment-level-even'); 
-} else { 
-    echo ' comment-parent'; 
-} 
-$comments->alt(' comment-odd', ' comment-even'); 
-echo $commentClass; 
-?>"> 
-</code> 
-\\ 
-有了这两段函数以后,剩下的工作就很简单了。以我要替换管理员在评论中名字的背景为例。首先将打印出来的字段应用到 HTML 的调用中: 
-<code php> 
-<span class="comment-author<?php echo $commentClass; ?>"><?php $comments->author(); ?></span> 
-</code> 
- 
-上面的代码直接把 ''$commentClass'',也就是我们要额外附加的样式表加入了 ''comment-author'' 这个样式里。如果是管理员,那么调用的样式表就是 ''.comment-author.comment-by-author'',否则就是 ''.comment-author.comment-by-user'' 
-\\ 
-\\ 
-最后去 CSS 里添加样式表即可: 
- 
-<code css> 
-.comment-author.comment-by-author {background: #636363;padding: 5px;} 
-</code> 
-==评论:重写发表评论时间== 
-Typecho 默认的时间输出格式是 PHP 的格式。如果我们希望将其转换为“发表于多久多久之前” 的格式,可以通过以下的手段来实现: 
-\\ 
-\\ 
-首先我们需要往 ''function.php'' 中添加一个时间重写函数: 
-<code php> 
-//时间转换输出 
-function timesince($older_date,$comment_date = false) { 
-$chunks = array( 
-array(86400 , 'Day'), 
-array(3600 , 'Hour'), 
-array(60 , 'Minute'), 
-array(1 , 'Second'), 
-); 
-$newer_date = time(); 
-$since = abs($newer_date - $older_date); 
- 
-for ($i = 0, $j = count($chunks); $i < $j; $i++){ 
-$seconds = $chunks[$i][0]; 
-$name = $chunks[$i][1]; 
-if (($count = floor($since / $seconds)) != 0) break; 
-} 
-/*如果是中文则不需要 count 的判断,并且也不需要空格*/ 
-if ($count == 1) { 
-$output = $count.' '.$name.' '.'ago'; 
-} 
-else {$output = $count.' '.$name.'s'.' '.'ago'; } 
-return $output; 
-} 
-</code> 
-这个函数会获取以前的时间作为参数,并转换成相应的字段,我们只需要拿到 ''comments.php'' 中使用即可。使用方法如下: 
-<code php> 
-<?php echo timesince($comments->created);?> 
-</code> 
-==评论:回复评论自带@跳转== 
-首先到 ''function.php'' 中添加如下两个函数: 
-<code php> 
-//获取评论的锚点链接 
-function get_comment_at($coid) 
-{ 
-    $db   = Typecho_Db::get(); 
-    $prow = $db->fetchRow($db->select('parent')->from('table.comments') 
-                                 ->where('coid = ? AND status = ?', $coid, 'approved')); 
-    $parent = $prow['parent']; 
-    if ($parent != "0") { 
-        $arow = $db->fetchRow($db->select('author')->from('table.comments') 
-                                     ->where('coid = ? AND status = ?', $parent, 'approved')); 
-        $author = $arow['author']; 
-        $href   = '<a href="#comment-' . $parent . '">@' . $author . '</a>'; 
-        echo $href; 
-    } else { 
-        echo ''; 
-    } 
-} 
-//输出评论内容 
-function get_filtered_comment($coid){ 
-    $db   = Typecho_Db::get(); 
-    $rs=$db->fetchRow($db->select('text')->from('table.comments') 
-                                 ->where('coid = ? AND status = ?', $coid, 'approved')); 
-    $content=$rs['text']; 
-    echo $content; 
-} 
-?> 
-</code> 
-\\ 
-再到 ''comments.php'' 中使用如下代码调用即可: 
-<code linenums:1> 
-<?php get_comment_at($comments->coid)?> 
-</code> 
-==添加自定义html标签到文章内容== 
-找到文件夹 ''/var'' 下的文件 ''HyperDown.php'' 第十七行,添加需要使用的标签即可。 
-===Typecho 升级指南=== 
- 
-//Typecho// 可以通过以下方式来进行升级: 
- 
-  - 下载最新的版本:[[https://github.com/typecho/typecho|Typecho On Github]] 
-  - 删除服务器上三个目录的文件,如果修改了源代码可以使用 //Github// 的对比工具来进行合并。三个目录分别是:''/admin'', ''/var'', 和根目录下的 ''index.php'' 
-  - 上传最新的对应文件即可。 
- 
-===Typecho URL重写=== 
- 
-==Apache 重写规则== 
-添加如下代码到 ''.htaccess'' 文件中即可。注意:''RewriteBase'' 后是网站的目录。 
-<code apache> 
-<IfModule mod_rewrite.c > 
-    RewriteEngine On 
-    RewriteBase / 
-    RewriteCond %{REQUEST_FILENAME} !-f 
-    RewriteCond %{REQUEST_FILENAME} !-d 
-    RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1] 
-</IfModule> 
-</code> 
- 
-===InstantClick=== 
- 
-''instantclick.js'' 是一种ajax无刷新和预加载页面的技术,对于普通博客程序,有着明显的加速作用。''instantclick.js'' ≈ ''pjax'' 加上预加载页面,而且,使用方法也十分的简单。 
- 
-==安装InstantClick== 
- 
-下载 [[http://instantclick.io/download|InstantClick]] 
-\\ 
-\\ 
-在 ''footer.php'' 的 ''</body>'' 标签之前插入以下代码: 
-<code js> 
-... 
-<script src="instantclick.min.js" data-no-instant></script> 
-<script data-no-instant>InstantClick.init();</script> 
-</body> 
-</html> 
-</code> 
- 
-==点击时候的预加载== 
- 
-默认情况下是在鼠标悬停到链接上方即开始加载,有时候这样会带来服务器的额外开销问题。将 ''init'' 函数的参数设置为 ''mousedown'' 则可以通过点击的一瞬间进行预加载: 
-<code> 
-InstantClick.init('mousedown'); 
-</code> 
- 
-==修改预加载条的颜色== 
- 
-在样式表中加入如下代码即可: 
-<code css> 
-#instantclick-bar { background: gray; } 
-</code> 
- 
-==与 PrismJS兼容== 
- 
-先对 ''Prismjs'' 中需要预加载的部分进行设置: 
-\\ 
-\\ 
-打开 ''Plugin.php'' 文件,找到 ''58'' 行: 
-<code html js> 
-<script>var pres = document.getElementsByTagName('pre'); 
-</code> 
-改为: 
-<code html> 
-<script data-no-instant>var pres = document.getElementsByTagName('pre'); 
-</code> 
-找到 ''64'' 行: 
-<code html> 
-<script src="' . $jsUrl . '"></script> 
-</code> 
-改为: 
-<code html> 
-<script src="' . $jsUrl . '" data-no-instant></script> 
-</code> 
-找到 ''66'' 行: 
-<code html> 
-<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '"></script> 
-</code> 
-改为: 
-<code html js> 
-<script defer="defer" src="' . Helper::options()->pluginUrl . '/Prismjs/line-number-wrap-fix.js' . '" data-no-instant></script> 
-</code> 
-\\ 
-再修改位于 ''footer.php'' 中 ''instantclick'' 的白名单部分,添加属于 ''prismjs'' 的规则: 
-<code js> 
-if (typeof Prism !== 'undefined') {<?php  if (Helper::options()->plugin('Prismjs')->showln): ?> 
-var pres = document.getElementsByTagName('pre'); 
-    for (var i = 0; i < pres.length; i++){ 
-        if (pres[i].getElementsByTagName('code').length > 0) 
-            pres[i].className  = 'line-numbers';} <?php endif; ?> 
-Prism.highlightAll(true,null);} 
-</code> 
-PHP 部分: 
-<code php> 
-{<?php  if (Helper::options()->plugin('Prismjs')->showln): ?>''  
-</code> 
-对判断插件是否使用了行号。如果没启用插件,会导致网站 **505** 错误。 
-\\ 
-\\ 
-如果不使用行号,直接使用以下代码: 
-<code php> 
- if (typeof Prism !== 'undefined') { Prism.highlightAll(true,null); } 
-</code> 
- 
-===Mathjax=== 
- 
-==Mathjax与InstantClick不兼容== 
- 
-在 ''footer.php'' 中找到 ''InstantClick.on('change', function(isInitialLoad)'' 部分,加入以下规则: 
-<code> 
-if (typeof MathJax !== 'undefined'){MathJax.Hub.Queue(["Typeset",MathJax.Hub]);} 
-</code> 
-==Mathjax的直接添加== 
- 
-在 ''header.php'' 中的 ''<head>'' 之间加入如下代码: 
-<code html> 
-<script type="text/x-mathjax-config"> 
-  MathJax.Hub.Config({ 
-    extensions: ["tex2jax.js"], 
-    jax: ["input/TeX", "output/HTML-CSS"], 
-    tex2jax: { 
-      inlineMath: [ ['$','$'], ["\\(","\\)"] ], 
-      displayMath: [ ['$$','$$'], ["\\[","\\]"] ], 
-      processEscapes: true 
-    }, 
-     
-    "HTML-CSS": { availableFonts: ["TeX"] } 
-  }); 
-</script> 
-<script type="text/javascript" 
-   src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"> 
-</script> 
-</code> 
-<WRAP center round info 100%> 
-近日 //MathJax// 自营 CDN 已经停止服务,需自行寻找相关 CDN。 
-</WRAP> 
-\\ 
-==Mathjax按需加载== 
-首先在 ''post.php'' 中添加一个全局变量用于检测页面是否有数学公式: 
-<code php> 
-<?php $GLOBALS['mathjax'] = strpos($this->content, '[') || strpos($this->content, '('); ?> 
-</code> 
-接着到 Mathjax.js 调用的地方设置条件(我的是''footer.php''): 
-<code php> 
-<?php if($GLOBALS['mathjax']):?> 
-  <!--mathjax--> 
-  <script type="text/javascript" src="https://cdn.staticfile.org/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script> 
-<?php endif;?> 
-</code> 
- 
-==Mathjax不显示加载信息== 
-在 ''MathJax.Hub.Config'' 中添加如下代码: 
-<code js> 
-showProcessingMessages: false, //关闭js加载过程信息 
-messageStyle: "none", //不显示信息 
-</code> 
- 
-===Disqus=== 
- 
-==Disqus loading on scroll== 
- 
-<del>本实现需要 ''jquery'' 支持,并编辑  ''comments.php''。</del> 
-\\ 
-<WRAP round tip 60%> 
-新版本不再使用 jquery。 
-</WRAP> 
- 
-\\ 
-\\ 
-在 ''comments.php'' 中加入 如下 JS 代码: 
-<code js> 
-<script> 
-var disqus_loaded = false; 
- 
-function load_disqus() 
-{ 
-  disqus_loaded = true; 
-  var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true; 
-  dsq.src = "https://codinghare.disqus.com/embed.js"; 
-  (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq); 
-} 
- 
-window.onscroll = function(e) { 
-    if ((window.innerHeight + window.scrollY) >= document.body.offsetHeight) { 
-        //hit bottom of page 
-        if (disqus_loaded==false){ load_disqus() }; 
-    } 
-}; 
-</script> 
-</code> 
-\\ 
-注意替换 ''embed.js'' 的地址为自己的 Disqus地址(直接替换 shortname 即可)。 
-\\ 
-\\ 
-html 调用: 
-<code html> 
-<div id="disqus_thread"></div> 
-</code> 
-\\ 
-\\ 
-====Flarum==== 
-===解决 nginx 重写的问题=== 
-Flarum 自己带一个子目录 ''public'' 作为论坛的首页目录。很多网上的教程建议直接重写 vhost 中的 root 路径,但 AMH 对此似乎并不友好。另外一种办法是通过面板建立**子域主机**来重新定向域名的根目录到 ''public''。举个例子,如果需要指定域名 domain.com 到该目录,需要修改的如下: 
-  -  绑定 ''127.0.0.1'' 到**父主机** 
-  - 绑定 domain.com 到子域主机 
-  - 绑定子目录中填写 ''/public'' 
-  - 在子主机中包含 ''.nginx.conf''(位于父主机网站根目录下),可参考官方安装帮助。  
- 
-===Flarum 目录权限=== 
-<code bash> 
-$chown www:www -R /home/wwwroot/环境/domain/域名/web/ 
-</code> 
-===InnodB=== 
-如果遇到以下的错误: 
->flarum Something went wrong: SQLSTATE[42000]: Syntax error or access violation: 1286 Unknown storage engine 'InnoDB' 
-需要到 ''MAadmin'' - ''参数设置'' 中打开 ''InnoDB'' 的开关。 
-===https 403=== 
-如果出现 http 访问正常 而 https 访问 403 的情况,需要到 ''config.php'' 做如下修改: 
-<code cpp> 
-//default 
-http://yourdomain.com  
-//change to 
-https://yourdomain.com  
-</code>